🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP →
superbrain-server
Advanced tools
superbrain-server - npm Package Compare versions
+1
-1
| { | ||
| "name": "superbrain-server", | ||
| "version": "1.0.55", | ||
| "version": "1.0.56", | ||
| "description": "1-Line Auto-Installer and Server Execution wrapper for SuperBrain", | ||
@@ -5,0 +5,0 @@ "main": "index.js", |
+109
-106
@@ -1,106 +0,109 @@ | ||
| ��# s u p e r b r a i n - s e r v e r | ||
| O n e - c o m m a n d i n s t a l l e r a n d l a u n c h e r f o r t h e S u p e r B r a i n b a c k e n d . | ||
| A s e l f - h o s t e d A I - p o w e r e d s e c o n d b r a i n f o r A n d r o i d s a v e I n s t a g r a m p o s t s , Y o u T u b e v i d e o s , a n d w e b p a g e s d i r e c t l y f r o m t h e s h a r e s h e e t , h a v e t h e m a u t o m a t i c a l l y a n a l y s e d b y A I , a n d r e d i s c o v e r t h e m w i t h i n t e l l i g e n t s e a r c h , c o l l e c t i o n s , a n d s m a r t n o t i f i c a t i o n s . | ||
| # # F e a t u r e s I n c l u d e d i n T h i s S e r v e r | ||
| - * * M u l t i - p r o v i d e r A I R o u t e r * * : A u t o m a t i c l o a d - b a l a n c i n g a c r o s s G r o q , G o o g l e G e m i n i , O p e n R o u t e r , a n d l o c a l O l l a m a . | ||
| - * * B a c k g r o u n d M u s i c I d e n t i f i c a t i o n * * : A u t o m a t i c d e t e c t i o n o f b a c k g r o u n d t r a c k s f r o m I n s t a g r a m R e e l s ( p o w e r e d b y S h a z a m ) . | ||
| - * * A u d i o T r a n s c r i p t i o n * * : G r o q W h i s p e r A P I ( c l o u d ) w i t h l o c a l O p e n A I W h i s p e r a s a n o f f l i n e f a l l b a c k . | ||
| - * * D o c k e r S u p p o r t * * : C o n t a i n e r i z e d , r e p r o d u c i b l e d e p l o y m e n t r e a d y f o r s e r v e r s . | ||
| - * * N a t i v e Y o u T u b e & W e b A n a l y s i s * * : S c r a p e s a n d a n a l y z e s c o n t e n t i n t e l l i g e n t l y w i t h o u t m e s s y m a n u a l d o w n l o a d s . | ||
| # # I n s t a l l a n d R u n | ||
| # # # R e c o m m e n d e d ( N o G l o b a l I n s t a l l ) | ||
| ` ` ` b a s h | ||
| n p x - y s u p e r b r a i n - s e r v e r @ l a t e s t | ||
| ` ` ` | ||
| # # # G l o b a l I n s t a l l ( O p t i o n a l ) | ||
| ` ` ` b a s h | ||
| n p m i n s t a l l - g s u p e r b r a i n - s e r v e r | ||
| s u p e r b r a i n - s e r v e r | ||
| ` ` ` | ||
| # # W h a t I t D o e s o n F i r s t R u n | ||
| 1 . U n p a c k s b a c k e n d f i l e s i n t o ` ~ / . s u p e r b r a i n - s e r v e r ` | ||
| 2 . C r e a t e s a n i s o l a t e d P y t h o n v i r t u a l e n v i r o n m e n t | ||
| 3 . I n s t a l l s P y t h o n d e p e n d e n c i e s | ||
| 4 . R u n s i n t e r a c t i v e s e t u p ( A I k e y s , o p t i o n a l I n s t a g r a m , t o k e n ) | ||
| 5 . S t a r t s t h e b a c k e n d A P I s e r v e r | ||
| # # R e q u i r e m e n t s | ||
| - N o d e . j s 2 0 + | ||
| - P y t h o n 3 . 1 0 + | ||
| - f f m p e g | ||
| # # C o m m a n d s | ||
| ` ` ` b a s h | ||
| # S t a r t s e r v e r | ||
| s u p e r b r a i n - s e r v e r | ||
| # S h o w c o n n e c t i o n Q R c o d e & r u n n i n g s e r v e r i n f o | ||
| s u p e r b r a i n - s e r v e r s t a t u s | ||
| # U p d a t e t h e b a c k e n d c o m p o n e n t s | ||
| s u p e r b r a i n - s e r v e r u p d a t e | ||
| # C o n f i g u r e N g r o k t u n n e l | ||
| s u p e r b r a i n - s e r v e r n g r o k | ||
| # O p e n i n t e r a c t i v e r e s e t m e n u | ||
| s u p e r b r a i n - s e r v e r r e s e t | ||
| # F u l l r e s e t ( d e s t r u c t i v e ) | ||
| s u p e r b r a i n - s e r v e r r e s e t - - a l l | ||
| ` ` ` | ||
| * ( Y o u c a n a l s o r u n a l l o f t h e s e v i a ` n p x - y s u p e r b r a i n - s e r v e r @ l a t e s t < c o m m a n d > ` ) * | ||
| # # D e f a u l t R u n t i m e L o c a t i o n | ||
| T h e b a c k e n d i s p e r m a n e n t l y i n s t a l l e d u n d e r y o u r u s e r h o m e d i r e c t o r y : | ||
| - * * W i n d o w s * * : ` % U S E R P R O F I L E % \ . s u p e r b r a i n - s e r v e r ` | ||
| - * * m a c O S / L i n u x * * : ` ~ / . s u p e r b r a i n - s e r v e r ` | ||
| # # C o n n e c t M o b i l e A p p | ||
| A f t e r t h e b a c k e n d s t a r t s : | ||
| 1 . C o p y t h e A c c e s s T o k e n s h o w n i n t h e b a c k e n d c o n s o l e . | ||
| 2 . O p e n t h e S u p e r B r a i n a p p S e t t i n g s . | ||
| 3 . E n t e r y o u r s e r v e r I P / U R L a n d t h e A c c e s s T o k e n . | ||
| # # T r o u b l e s h o o t i n g | ||
| # # # P y t h o n N o t F o u n d | ||
| I n s t a l l P y t h o n 3 . 1 0 + a n d v e r i f y : | ||
| ` ` ` b a s h | ||
| p y t h o n - - v e r s i o n | ||
| ` ` ` | ||
| * ( O n W i n d o w s , ` p y - 3 - - v e r s i o n ` s h o u l d a l s o w o r k ) . * | ||
| # # # B a c k e n d N o t R e a c h a b l e f r o m P h o n e | ||
| I f y o u a r e n o t o n t h e s a m e l o c a l n e t w o r k , e x p o s e t h e l o c a l p o r t w i t h N g r o k : | ||
| ` ` ` b a s h | ||
| n g r o k h t t p 5 0 0 0 | ||
| ` ` ` | ||
| U s e t h e g e n e r a t e d H T T P S U R L i n t h e a p p ' s S e t t i n g s . | ||
| # # L i n k s | ||
| - * * G i t H u b R e p o s i t o r y * * : [ s i d i n s e a r c h / s u p e r b r a i n ] ( h t t p s : / / g i t h u b . c o m / s i d i n s e a r c h / s u p e r b r a i n ) | ||
| - * * M a i n P r o j e c t D o c s * * : [ R E A D M E ] ( h t t p s : / / g i t h u b . c o m / s i d i n s e a r c h / s u p e r b r a i n # r e a d m e ) | ||
| - * * N P M P a c k a g e * * : [ s u p e r b r a i n - s e r v e r ] ( h t t p s : / / w w w . n p m j s . c o m / p a c k a g e / s u p e r b r a i n - s e r v e r ) | ||
| # # L i c e n s e | ||
| M I T ( C L I w r a p p e r ) | ||
| #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 | ||
| 1. **Recommended** (No Global Install) | ||
| ```bash | ||
| npx -y superbrain-server@latest | ||
| ``` | ||
| 2. **Global Install** | ||
| ```bash | ||
| npm install -g superbrain-server | ||
| superbrain-server | ||
| ``` | ||
| ## What It Does on First Run | ||
| 1. Unpacks backend files into ~/.superbrain-server | ||
| 2. Creates an isolated Python virtual environment | ||
| 3. Installs Python dependencies | ||
| 4. Runs interactive setup (AI keys, optional Instagram, token) | ||
| 5. 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: | ||
| ```bash | ||
| ngrok http 5000 | ||
| ``` | ||
| Use the generated HTTPS URL in the app's Settings. | ||
| ## Links | ||
| - **GitHub Repository**: [sidinsearch/superbrain](https://github.com/sidinsearch/superbrain) | ||
| - **Main Project Docs**: [README](https://github.com/sidinsearch/superbrain#readme) | ||
| - **NPM Package**: [superbrain-server](https://www.npmjs.com/package/superbrain-server) | ||
| ## License | ||
| MIT (CLI wrapper) |
New alerts
AI-detected potential code anomaly
Supply chain riskAI has identified unusual behaviors that may pose a security risk.
Fixed alerts
AI-detected potential code anomaly
Supply chain riskAI has identified unusual behaviors that may pose a security risk.
Improved metrics
- Number of lines in readme file
109
2.83%Worsened metrics
- Total package byte prevSize
511017
-0.57%No dependency changes