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 — 零云依赖、零成本、完全隐私
✨ 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 Setup —
pip 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file opc_agent-0.5.0.tar.gz.
File metadata
- Download URL: opc_agent-0.5.0.tar.gz
- Upload date:
- Size: 179.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fdc40f6043dbc2902b7e307d65c32b61e0396179a11e06d37884592978721a4b
|
|
| MD5 |
5076808232e58727670fdc9d77a7e7be
|
|
| BLAKE2b-256 |
2ff410f5b2cf4ffcbe8cf2a79f08bbb7eeb0cc1cdd031df951afd13c1f975354
|
File details
Details for the file opc_agent-0.5.0-py3-none-any.whl.
File metadata
- Download URL: opc_agent-0.5.0-py3-none-any.whl
- Upload date:
- Size: 179.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6f5bdebdde03495033d50fc5181eee18b977e8acc66c19b6031762c87f1cc025
|
|
| MD5 |
d30da6297cc54335d102a74cc7824084
|
|
| BLAKE2b-256 |
2c585a97cc1c95f5b46fb1ff1076186152ab4682a5c59e1830fae9f85db7b951
|