superbrain-server

superbrain-server

One-command installer and launcher for the SuperBrain backend.

A self-hosted AI-powered second brain for Android - save Instagram posts, YouTube videos, and web pages directly from the share sheet, have them automatically analysed by AI, and rediscover them with intelligent search, collections, and smart notifications.

Features Included in This Server

• Multi-provider AI Router: Automatic load-balancing across Groq, Google Gemini, OpenRouter, and local Ollama.
• Background Music Identification: Automatic detection of background tracks from Instagram Reels (powered by Shazam).
• Audio Transcription: Groq Whisper API (cloud) with local OpenAI Whisper as an offline fallback.
• Docker Support: Containerized, reproducible deployment ready for servers.
• Native YouTube & Web Analysis: Scrapes and analyzes content intelligently without messy manual downloads.

Install and Run

• Recommended (No Global Install)

  npx -y superbrain-server@latest
  

• Global Install

  npm install -g superbrain-server
  superbrain-server
  

What It Does on First Run

• Unpacks backend files into ~/.superbrain-server
• Creates an isolated Python virtual environment
• Installs Python dependencies
• Runs interactive setup (AI keys, optional Instagram, token)
• Starts the backend API server

Requirements

Dependency	Version
Node.js	20+
Python	3.10+
ffmpeg	latest

Commands

# Start server
superbrain-server

# Show connection QR code & running server info
superbrain-server status

# Update the backend components
superbrain-server update

# Configure Ngrok tunnel
superbrain-server ngrok

# Open interactive reset menu
superbrain-server reset

# Full reset (destructive)
superbrain-server reset --all

Tip: You can also run all of these via npx -y superbrain-server@latest <command>

Default Runtime Location

The backend is permanently installed under your user home directory:

• Windows: %USERPROFILE%\.superbrain-server
• macOS / Linux: ~/.superbrain-server

Connect Mobile App

After the backend starts:

• Copy the Access Token shown in the backend console.
• Open the SuperBrain app Settings.
• Enter your server IP/URL and the Access Token.

Troubleshooting

Python Not Found

Install Python 3.10+ and verify:

python --version

On Windows, py -3 --version should also work.

Backend Not Reachable from Phone

If you are not on the same local network, expose the local port with Ngrok:

ngrok http 5000

Use the generated HTTPS URL in the app's Settings.

Links

• GitHub Repository: sidinsearch/superbrain
• Main Project Docs: README
• NPM Package: superbrain-server

License

MIT (CLI wrapper)