👻 SPECTER

The open-source AI agent.
Like OpenClaw — but you own it 100%. No SaaS, no vendor lock-in, no one else touching your keys.

Run it on your VPS. On your laptop. Inside a container. Wherever you want.

SPECTER manages your server, browses the web, runs sub-agents, reads/writes files, and does anything you ask.

Quick Start

Option A: pip (laptop / local)

pip install specter
specter

First time? It'll ask for your LLM API key. That's it.

Or start the Telegram bot:

specter-telegram

Option B: Docker (VPS / server)

mkdir specter && cd specter
wget https://raw.githubusercontent.com/Nabilkarem911/SPECTER/main/docker-compose.yml
wget https://raw.githubusercontent.com/Nabilkarem911/SPECTER/main/.env.example -O .env

# Edit .env — add your keys
nano .env

docker compose up -d

What SPECTER Can Do

Your API keys stay on your machine. We never see them.

Architecture

You (CLI / Telegram / API)
  └─ SPECTER Agent
       ├─ LLM Router → Any provider (DeepSeek, OpenAI, Claude...)
       ├─ Memory     → ChromaDB + SQLite
       ├─ Tools      → Terminal, File, Web, Browser
       ├─ Agent Pool → Sub-agents for complex tasks
       └─ Learning   → Improves over time

Requirements

• Python 3.10+
• An LLM API key (DeepSeek is cheap: ~$0.27 per million tokens)
• (Optional) Docker for server deployment

License

MIT — do whatever you want. This is yours.