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.5.0.tar.gz (179.3 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.5.0-py3-none-any.whl (179.4 kB view details)

Uploaded Python 3

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

Hashes for opc_agent-0.5.0.tar.gz
Algorithm Hash digest
SHA256 fdc40f6043dbc2902b7e307d65c32b61e0396179a11e06d37884592978721a4b
MD5 5076808232e58727670fdc9d77a7e7be
BLAKE2b-256 2ff410f5b2cf4ffcbe8cf2a79f08bbb7eeb0cc1cdd031df951afd13c1f975354

See more details on using hashes here.

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

Hashes for opc_agent-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6f5bdebdde03495033d50fc5181eee18b977e8acc66c19b6031762c87f1cc025
MD5 d30da6297cc54335d102a74cc7824084
BLAKE2b-256 2c585a97cc1c95f5b46fb1ff1076186152ab4682a5c59e1830fae9f85db7b951

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