Skip to main content

Local-first AI Agent for Mac. Zero cloud dependency.

Project description

🤖 OPC Agent

Your 100% Local AI Agent — Zero Cloud, Zero Cost, Total Privacy

纯本地 AI Agent — 零云依赖、零成本、完全隐私

PyPI version Downloads GitHub stars License Python

Website · Quick Start · Docs · vs Leaper Agent


✨ Why OPC Agent? / 为什么选 OPC Agent?

OPC Agent is a fully local AI agent powered by Ollama. No API keys, no cloud, no subscriptions. Your data never leaves your machine — and the agent gets smarter over time with built-in DeepBrain memory.

  • 🔒 100% Local — Runs entirely on your Mac, PC, or Linux. No internet required after setup.
  • 💰 Zero Cost — No API fees, no subscriptions. Just your hardware.
  • 🧠 Self-Learning Memory — Built-in DeepBrain 6-layer memory. Your agent remembers and evolves.
  • 🛡️ Privacy First — Your conversations, your data, your machine. Period.
  • Simple Setuppip install + ollama pull = ready to go.

🚀 Quick Start

Prerequisites

  • Python 3.10+
  • Ollama installed and running

Install & Run

# 1. Install
pip install opc-agent

# 2. Init — auto-detects your device & pulls the best model
opc init

# 3. Start!
opc start

opc init automatically:

  • 🔍 Detects your hardware — Apple Silicon, NVIDIA GPU, AMD GPU, or CPU-only
  • 📦 Pulls the best model — matches model size to your GPU/RAM
  • 🧠 Sets up DeepBrain — pulls embedding model for memory search
Your Device Model Selected Size
Mac M4 Pro 48GB Qwen 2.5 72B ~40GB
Mac M2 16GB Qwen 2.5 14B ~9GB
NVIDIA RTX 4090 24GB Qwen 2.5 32B ~18GB
NVIDIA RTX 3060 12GB Qwen 2.5 14B ~9GB
CPU only 8GB Qwen 2.5 3B ~2GB

No API keys. No config files. No cloud accounts. Zero decisions required.

🧠 Built-in DeepBrain Memory

OPC Agent includes DeepBrain — a 6-layer self-evolving knowledge engine:

⚡ Flash → 📝 Short-Term → 📚 Long-Term → 🏗️ Consolidated → 🗄️ Archived → 🔮 Meta

Your agent automatically:

  • Remembers key facts from conversations
  • Consolidates patterns across sessions
  • Promotes validated knowledge to long-term storage
  • Evolves its understanding over time

All stored in a local SQLite database. No cloud sync. No data leakage.

📖 Usage

# Initialize (check Ollama + models)
opc init

# Start agent (opens Web UI in browser)
opc start

# Open chat in browser (starts server if needed)
opc chat

# Check status
opc status

# Stop agent
opc stop

Web UI

OPC Agent runs as a local web server with a chat UI at http://localhost:3000. Features: conversation history, model switching, DeepBrain memory integration.

Configuration

# All data stored locally
~/.opc/
~/.opc/
├── brain.db           # DeepBrain knowledge store
├── conversations.db   # Chat history
├── config.json        # Settings
└── agents/            # Agent workspaces

⚖️ OPC Agent vs Leaper Agent

OPC Agent Leaper Agent
LLM Ollama (local models) OpenAI / Claude / Gemini
Internet Required No Yes (API calls)
Cost $0 Pay-per-token
Privacy ⭐⭐⭐⭐⭐ ⭐⭐⭐
Model Quality Good (local models) Best (GPT-4, Claude 3.5)
Multi-Agent
Telegram Bot
Best For Privacy, offline, zero-cost Power users, teams, integrations

Want cloud models? → Check out Leaper Agent 在中国? → Check out Leaper Agent CN

🖥️ Supported Platforms

Platform Status
macOS (Apple Silicon) ✅ Recommended
macOS (Intel)
Linux (x86_64)
Windows 10/11

📄 License

BSL-1.1 — see LICENSE for details.

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md.

📧 Questions? tech@deepleaper.com


Built with ❤️ by Deepleaper Technology / 跃盟科技

Local AI that remembers. Private AI that evolves.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

opc_agent-0.4.0.tar.gz (179.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

opc_agent-0.4.0-py3-none-any.whl (180.3 kB view details)

Uploaded Python 3

File details

Details for the file opc_agent-0.4.0.tar.gz.

File metadata

  • Download URL: opc_agent-0.4.0.tar.gz
  • Upload date:
  • Size: 179.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for opc_agent-0.4.0.tar.gz
Algorithm Hash digest
SHA256 473abf944162e29943b188656368eff940f95f2be4c22c126bdb2aaf21118982
MD5 065dfd8663622da758376455b49207a1
BLAKE2b-256 f2465a9267a50275bc0f8253e561aa7bd1347c5f52780ff6fd1929a9db200a58

See more details on using hashes here.

File details

Details for the file opc_agent-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: opc_agent-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 180.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for opc_agent-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c17fbc4f1abb230e385350dec2e36dc3d46eafa65e4342307d35710593623a6f
MD5 7269699be69abbc4837560a8626527e9
BLAKE2b-256 379591d89159365f663d486676bf6631e1e69a9b52b653d09115d4a132adda54

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page