Step 8

Install & Launch OneAiMind

The final step — clone the app, configure it, and start your personal AI assistant.

Clone & Configure

bash

# Clone the repository
cd ~
git clone https://github.com/OneAiMind/OneAiMind.git
cd OneAiMind

# Create your environment config
cp .env.example .env
nano .env

Environment Configuration

.env configuration

# ── Local AI ────────────────────────────
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=qwen2.5:14b
OLLAMA_FAST_MODEL=llama3.2:latest
OLLAMA_EMBED_MODEL=nomic-embed-text

# ── Database ─────────────────────────────
DATABASE_URL=postgresql://oneaimind_user:YourPassword@localhost:5432/oneaimind

# ── App ──────────────────────────────────
PORT=3000
NODE_ENV=production

# ── Optional Cloud AI ────────────────────
ANTHROPIC_API_KEY=
OPENAI_API_KEY=
GEMINI_API_KEY=

Install Dependencies & Start

bash

# Install Node.js packages
npm install

# Python voice environment
python3 -m venv .venv
source .venv/bin/activate
pip install faster-whisper piper-tts pyaudio sounddevice numpy

# Launch OneAiMind!
npm start

💡

OneAiMind is running! 🚀

Open your browser and go to: http://localhost:3000
From another device on your network: http://<your-server-ip>:3000

Auto-Start on Boot (Recommended)

bash

# Create systemd service (replace 'yourusername' with your actual username)
sudo nano /etc/systemd/system/oneaimind.service

systemd service file

[Unit]
Description=OneAiMind AI Assistant
After=network.target postgresql.service ollama.service

[Service]
Type=simple
User=yourusername
WorkingDirectory=/home/yourusername/OneAiMind
ExecStart=/usr/bin/node /home/yourusername/OneAiMind/server/index.js
Restart=on-failure
RestartSec=10
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

bash

# Enable and start
sudo systemctl daemon-reload
sudo systemctl enable oneaimind
sudo systemctl start oneaimind
sudo systemctl status oneaimind

Open Firewall for Portal Access

Ubuntu's firewall (UFW) blocks incoming connections by default. To access the OneAiMind portal from other devices on your network — phones, tablets, laptops — you need to open the app port.

bash

# Check firewall status
sudo ufw status

# Enable the firewall if it's inactive
sudo ufw enable

# Open OneAiMind web portal (port 3000)
sudo ufw allow 3000/tcp comment 'OneAiMind Portal'

# Allow SSH so you don't lock yourself out
sudo ufw allow 22/tcp comment 'SSH'

# Verify the rules
sudo ufw status numbered

⚠️

Always keep SSH open

If you're managing the server remotely, make sure port 22 (SSH) is allowed beforeenabling UFW. Otherwise you'll lose remote access.

Find Your Server IP

bash

# Show your local network IP address
hostname -I | awk '{print $1}'

Then open a browser on any device connected to the same network and go to:

browser

http://<your-server-ip>:3000

💡

Bookmark it

For example, if your server IP is 192.168.1.42, open http://192.168.1.42:3000 on your phone or laptop. Bookmark it for easy access.

Full Health Check

bash

systemctl is-active postgresql && echo "✅ PostgreSQL: Running" || echo "❌ PostgreSQL: Stopped"
systemctl is-active ollama && echo "✅ Ollama: Running" || echo "❌ Ollama: Stopped"
systemctl is-active oneaimind && echo "✅ OneAiMind: Running" || echo "❌ OneAiMind: Stopped"
echo ""; ollama list
curl -s http://localhost:3000/api/health

ℹ️

Congratulations! 🎉

You now have a fully private, locally-running AI assistant. All your data stays on your machine — nothing is sent to the cloud.

← PostgreSQL Troubleshooting →