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-1.0.0.tar.gz (196.2 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-1.0.0-py3-none-any.whl (198.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for opc_agent-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ca2471e55aad07d4fd2941b021207556ff910a4981245ab765bced9d0a8322f1
MD5 56d8b57f98f62ec9ba6bbd684ba082a7
BLAKE2b-256 e3726ebc65c459d81a0336fcaaae2474120ef68f48fbc181fc68ece76971f49a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: opc_agent-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 198.7 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-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 945dfdf315abc1cc28f1f025fab03c47c73e34c0c029789fac672883b0b52419
MD5 31f3b7e6342daf92573483cc452d72f4
BLAKE2b-256 b6ef6529aaf8def0b3946ebf5036cd6d669f113fd71f0f806d0ef0aeafaa42de

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