Registry / llm-agents / superbrain-server

superbrain-server

library1.0.60jsnpmunverified

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.

llm-agents ai-ml devops

npm install superbrain-server

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SUPERBRAIN-SERVER

superbrain-server

llm-agentsjavascriptv1.0.60

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

superbrain-server

✓ npx -y superbrain-server@latest

✗ import superbrainServer from 'superbrain-server';

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.

superbrain-server status

✓ npx -y superbrain-server@latest status

✗ import { status } from 'superbrain-server';

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`.

superbrain-server update

✓ npx -y superbrain-server@latest update

✗ require('superbrain-server').updateBackend();

This command updates the installed Python backend components and dependencies managed by the wrapper. It is executed via the CLI, similar to other subcommands.

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.

npx -y superbrain-server@latest

superbrain-server --version

Debug

Known issues

gotchaThe 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.

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`.

affects: >=1.0.0

gotchaThe 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.

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.

affects: >=1.0.0

gotchaThe 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.

fix

For advanced troubleshooting or direct access to backend files, navigate to `~/.superbrain-server` (Linux/macOS) or `%USERPROFILE%\.superbrain-server` (Windows).

affects: >=1.0.0

gotchaAfter 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.

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.

affects: >=1.0.0

gotchaIf 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.

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.

affects: >=1.0.0

Errors

Common errors & fixes

python: command not found

Python 3.10+ is not installed or is not accessible in the system's PATH environment variable.

fix

Install Python 3.10+ from python.org and ensure it's added to your system's PATH during installation, or manually add it.

Backend Not Reachable from Phone (user reported symptom)

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).

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.

Upgrade

Version history

1.0.60latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

29 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/sidinsearch/superbrain ↗

packagehttps://www.npmjs.com/package/superbrain-server ↗

homepagehttps://superbrain.io ↗