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

• Node.js 20+
• Python 3.10+
• ffmpeg

Commands

�``bash

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 ngroj

Open interactive reset menu

superbrain-server reset

Full reset (destructive)

superbrain-server reset --all

*(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:
1. Copy the Access Token shown in the backend console.
2. Open the SuperBrain app Settings.
3. Enter your server IP/URL and the Access Token.

## Troubleshooting

### Python Not Found
Install Python 3.10+ and verify:

``bash
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)