CogniSphere

AI Advanced Chat Bot

Getting Started

Installation

Note: Choose the instructions based on your operating system.

---

🐧 Ubuntu Server / Linux

You will need Node.js 18.9+ and npm installed on your local development machine:

sudo apt update && sudo apt install -y nodejs npm

You will then install the app in folder of your choice.

sudo mkdir /var/www
sudo mkdir /var/www/cognisphere
cd /var/www/cognisphere

sudo git config --global init.defaultBranch main
sudo git init
sudo git remote add origin https://github.com/wajihalsaid/cognisphere.git
sudo git pull --rebase origin main

sudo npm install
sudo npm run build

To run the app temporary:

npm start

To keep it always running even after reboot:

sudo npm install -g pm2
sudo pm2 start npm --name "cognisphere" -- start
sudo pm2 save
sudo pm2 startup

Open http://localhost:3000 with your browser to see the result.

---

Windows 11 (PowerShell)

Install Node.js & Git on Windows 11. Open PowerShell as Administrator and run:

winget install OpenJS.NodeJS.LTS
winget install Git.Git

Create your project folder and clone the repo

mkdir C:\Projects\cognisphere
cd C:\Projects\cognisphere
git init
git remote add origin https://github.com/wajihalsaid/cognisphere.git
git pull --rebase origin main

Install dependencies

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
npm install

Build the app

npm run build

Run temporarily

npm start

Open http://localhost:3000 with your browser to see the result. Ctrl+C to stop. you can use the same command to run it again.

---

macOS

Install Node.js and npm using macOS Terminal

brew install node

Create project folder and download code

mkdir -p ~/Projects/cognisphere
cd ~/Projects/cognisphere
git config --global init.defaultBranch main
git init
git remote add origin https://github.com/wajihalsaid/cognisphere.git
git pull --rebase origin main

Install dependencies

npm install

Build the app

npm run build

Run the app temporarily

npm start

Open http://localhost:3000 with your browser to see the result. Ctrl+C to stop. you can use the same command to run it again.

---

Pull & Use Anywhere (Docker)

If you just want to run Cognisphere without installing Node.js, npm, or cloning the repo, you can use Docker:

docker pull walsaid/cognisphere:latest
docker run -p 3000:3000 walsaid/cognisphere:latest

Open http://localhost:3000 with your browser. The app runs inside the Docker container. Stop it with Ctrl+C or by removing the container. You can run it again anytime with the same docker run command.

For K8s, Openshift, EKS, AKS, and GKE. Here is sample of yaml file

---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: cognisphere
spec:
  replicas: 2
  selector:
    matchLabels:
      app: cognisphere
  template:
    metadata:
      labels:
        app: cognisphere
    spec:
      containers:
        - name: cognisphere
          image: walsaid/cognisphere:latest
          ports:
            - containerPort: 3000
---
apiVersion: v1
kind: Service
metadata:
  name: cognisphere-service
spec:
  selector:
    app: cognisphere
  ports:
    - protocol: TCP
      port: 80
      targetPort: 3000
  type: LoadBalancer
---

Keep your sevrer running latest version (on-demand):

---

🐧 Ubuntu Server / Linux

[optional] Create an on-demand script that it will make your project to get latest updates

sudo tee -a /var/www/cognisphere/.git/hooks/post-receive > /dev/null <<EOF
#!/bin/bash
APP_DIR="/var/www/cognisphere"
BRANCH="main"  # Change to the branch you are pulling from

cd \$APP_DIR || exit

echo "🚀 Pulling latest changes from Git..."
git checkout -- .
git pull origin \$BRANCH

echo "📦 Installing dependencies..."
npm install --package-lock-only
npm install

echo "🔨 Building the Next.js app..."
npm run build

echo "♻️ Restarting Next.js app with PM2..."
pm2 restart cognisphere

echo "✅ Deployment completed!"
EOF

# Make the hook executable
sudo chmod +x /var/www/cognisphere/.git/hooks/post-receive

Whenever you want to run the update, execute the below command:

sudo bash /var/www/cognisphere/.git/hooks/post-receive 

---

Windows 11 (PowerShell)

[optional] Get latest update, build and run temporarily:

cd C:\Projects\cognisphere
git restore .
git pull origin main
npm install --package-lock-only
npm install
npm run build
npm start

---

macOS

[optional] Get latest update, build and run temporarily:

cd ~/Projects/cognisphere
git checkout -- .
git pull origin main
npm install --package-lock-only
npm install
npm run build
npm start