{"id":14951,"library":"superbrain-server","title":"SuperBrain Server Installer & CLI","description":"SuperBrain Server is an npm package acting as a command-line interface (CLI) wrapper for installing, configuring, and managing the SuperBrain Python backend. As of version 1.0.60, it provides a one-line setup for a self-hosted AI-powered second brain designed for Android devices, facilitating the analysis and organization of content from platforms like Instagram, YouTube, and the web. Its core functionalities include a multi-provider AI router for services like Groq, Gemini, OpenRouter, and Ollama, automatic background music identification via Shazam, and audio transcription using Groq Whisper with a local OpenAI Whisper fallback. The package simplifies the deployment process, handling Python virtual environment creation and dependency installation, and offers commands for status checking, updates, and network configuration (e.g., Ngrok). While specific release cadence is not explicitly stated, updates align with new features and improvements to the SuperBrain ecosystem, providing a robust, locally controlled alternative to cloud-based 'second brain' solutions.","status":"active","version":"1.0.60","language":"javascript","source_language":"en","source_url":"https://github.com/sidinsearch/superbrain","tags":["javascript","superbrain","server"],"install":[{"cmd":"npm install superbrain-server","lang":"bash","label":"npm"},{"cmd":"yarn add superbrain-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add superbrain-server","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package is a CLI wrapper for a Python backend. Its primary use is via command-line execution, not programmatic JavaScript imports. The `npx` command executes the latest version without global installation, handling all setup on first run.","wrong":"import superbrainServer from 'superbrain-server';","symbol":"superbrain-server","correct":"npx -y superbrain-server@latest"},{"note":"Subcommands extend the core CLI functionality. If the package is globally installed via `npm install -g superbrain-server`, you can omit `npx -y` and simply run `superbrain-server status`.","wrong":"import { status } from 'superbrain-server';","symbol":"superbrain-server status","correct":"npx -y superbrain-server@latest status"},{"note":"This command updates the installed Python backend components and dependencies managed by the wrapper. It is executed via the CLI, similar to other subcommands.","wrong":"require('superbrain-server').updateBackend();","symbol":"superbrain-server update","correct":"npx -y superbrain-server@latest update"}],"quickstart":{"code":"npx -y superbrain-server@latest","lang":"bash","description":"Initializes and runs the SuperBrain Python backend, performing all necessary system setup, Python environment creation, dependency installation, and interactive configuration for AI keys and other settings on the first execution."},"warnings":[{"fix":"Ensure Node.js version 20 or higher, Python version 3.10 or higher, and ffmpeg are installed and correctly configured in your system's environment variables before running `superbrain-server`.","message":"The SuperBrain Server backend requires specific external system dependencies (Node.js 20+, Python 3.10+, and ffmpeg) to be pre-installed and available in the system's PATH. Failure to meet these requirements will prevent the backend from installing or running correctly.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Allocate sufficient time for the first-time setup to complete, which may take several minutes. Be prepared to enter required API keys (e.g., for Groq, Gemini) during the interactive setup prompts.","message":"The initial run of `superbrain-server` (especially the first time on a new system) involves extensive setup, including unpacking files, creating a Python virtual environment, installing numerous Python dependencies, and an interactive configuration process for AI keys. This can take significant time and requires user interaction.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"For advanced troubleshooting or direct access to backend files, navigate to `~/.superbrain-server` (Linux/macOS) or `%USERPROFILE%\\.superbrain-server` (Windows).","message":"The SuperBrain backend, along with its configuration and data, is permanently installed in a hidden directory within the user's home directory (`~/.superbrain-server` on macOS/Linux or `%USERPROFILE%\\.superbrain-server` on Windows). Users should be aware of this location for troubleshooting, manual updates, or data management.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Carefully copy the full server address (IP/URL) and the Access Token displayed in the terminal after the server starts, then paste them accurately into the SuperBrain Android app's 'Server IP/URL' and 'Access Token' fields under settings.","message":"After the SuperBrain backend server starts, connecting the Android mobile app requires manually copying the server's IP/URL and a generated 'Access Token' from the backend console into the app's settings. Incorrect configuration will prevent the app from connecting to your self-hosted server.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use a tunneling service like Ngrok (e.g., `ngrok http 5000` if your server runs on port 5000) to create a publicly accessible URL for your backend. Use the generated HTTPS URL in your SuperBrain mobile app's settings.","message":"If your mobile device is not on the same local network as your SuperBrain server, the app will be unable to reach the backend directly. This typically requires exposing the local server to the internet via a tunneling service.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-19T00:00:00.000Z","next_check":"2026-07-18T00:00:00.000Z","problems":[{"fix":"Install Python 3.10+ from python.org and ensure it's added to your system's PATH during installation, or manually add it.","cause":"Python 3.10+ is not installed or is not accessible in the system's PATH environment variable.","error":"python: command not found"},{"fix":"If on a different network, use `ngrok http 5000` to expose the server publicly. If on the same network, check local firewall settings to ensure port 5000 is open.","cause":"The mobile device is on a different network than the server, or network firewall rules are blocking access to the server's port (default 5000).","error":"Backend Not Reachable from Phone (user reported symptom)"}],"ecosystem":"npm"}