⚡ Vanexa Agent

Your Sovereign AI — Controlled from Your Phone.

Vanexa Agent is a God-Tier autonomous AI that runs on your computer and is commanded from an Android app. It can write code, build apps, manage files, generate documents, search the web, and much more — all from the palm of your hand.

🚀 Quick Start (30 Seconds)

Choose your OS and paste the command into your terminal:

🍎 macOS / 🐧 Linux / WSL

curl -fsSL https://vanexa-installer.vercel.app/install.sh | bash

🪟 Windows (PowerShell)

irm https://vanexa-installer.vercel.app/install.ps1 | iex

That's it. The installer automatically handles everything (including Node.js if you don't have it).

After installation, pair with your phone:

vanexa-agent pair

📱 How It Works

┌─────────────┐         WebSocket (LAN)        ┌──────────────┐
│  📱 Phone   │ ◄──────────────────────────────► │  💻 Computer │
│  Vanexa App │    Commands & Live Status        │ vanexa-agent │
└─────────────┘                                  └──────────────┘
                                                       │
                                                       ▼
                                                 ┌──────────┐
                                                 │  🧠 LLM  │
                                                 │ Your Key │
                                                 └──────────┘

1. You type a task on your phone (e.g., "Build me a React app")
2. Vanexa Agent on your computer receives it over your local WiFi
3. The AI (using your own API key) executes the task autonomously
4. You monitor progress in real-time on your phone

🔧 Manual Installation (Advanced)

If you already have Node.js 18+ installed:

# Install globally
npm install -g vanexa-agent

# Start pairing
vanexa-agent pair

# Start the daemon
vanexa-agent start

🔑 BYOK (Bring Your Own Key)

Vanexa Agent uses your own API keys. No middleman, no subscription.

| Provider | Vision Support | Recommended Model | |----------|:--------------:|-------------------| | DeepSeek | ❌ | deepseek-v4-flash | | OpenAI | ✅ | gpt-4o | | Anthropic | ✅ | claude-3.5-sonnet | | Gemini | ✅ | gemini-2.5-flash | | Qwen | ❌ | qwen-turbo | | Ollama | ❌ | Any local model |

Configure your key in the Vanexa phone app under Agent → Settings → API Configuration.

🛠️ Troubleshooting

npx: command not found

Node.js is not installed. Use the Quick Start installer above, or install Node.js manually from nodejs.org.

EACCES: permission denied

On macOS/Linux, fix npm permissions:

sudo npm install -g vanexa-agent

Or use the recommended approach:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g vanexa-agent

Error: Cannot connect to phone

Make sure both devices are on the same WiFi network. The agent uses mDNS (Bonjour) for auto-discovery.

Windows: running scripts is disabled

Run PowerShell as Administrator and execute:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

🗑️ Uninstall

npm uninstall -g vanexa-agent

📄 License

MIT © Ikbal Fadilah

Built with ❤️ for the Sovereign AI Revolution