自进化 AI 员工框架 — 越用越聪明
Project description
🚀 Leaper Agent
The Agent Framework That Actually Remembers
Hermes-Compatible Agent Orchestration + DeepBrain 6-Layer Evolving Memory
🤔 The Problem
Every agent framework gives you tool-calling and multi-model support. None of them give you real memory.
- CrewAI? Flat key-value store, resets between runs.
- AutoGen? Conversation history only, no knowledge evolution.
- LangGraph? Checkpoints, not understanding.
- Hermes Agent? Skill files on disk — smart, but static.
Your agent forgets everything the moment the session ends.
💡 The Solution
Leaper Agent = Hermes Agent base + DeepBrain memory engine.
We took the proven Hermes Agent architecture — its agent loop, tool runtime, and multi-provider support — and integrated DeepBrain's 6-layer self-evolving memory engine. The result: an agent that gets smarter every time you talk to it.
Session 1: "I'm building a SaaS product with FastAPI and React."
Session 2: "What stack should I use for the admin panel?"
→ Agent recalls your tech choices, suggests FastAPI Admin + React
→ No manual context injection. It just knows.
🧠 Why Memory Matters
| What happens | Without memory | With DeepBrain |
|---|---|---|
| You mention your tech stack | Forgotten next session | Remembered forever, evolves over time |
| You correct the agent | Same mistake tomorrow | Learns the correction, never repeats |
| You have 50 conversations | Each starts from zero | Agent builds a knowledge graph of YOU |
| Knowledge conflicts | Silently contradicts itself | 4-Gate system detects & resolves conflicts |
6-Layer Memory Architecture
┌─────────────────────────────────────────┐
│ Layer 5: Meta-Knowledge │
│ "I know your tech preferences well, │
│ but I'm uncertain about your budget" │
├─────────────────────────────────────────┤
│ Layer 4: Archived — Historical ref │
├─────────────────────────────────────────┤
│ Layer 3: Consolidated — Cross-session │
├─────────────────────────────────────────┤
│ Layer 2: Long-Term — Validated facts │
├─────────────────────────────────────────┤
│ Layer 1: Short-Term — Recent context │
├─────────────────────────────────────────┤
│ Layer 0: Flash — Current session │
└─────────────────────────────────────────┘
↑ Auto-promotion via 4-Gate QC ↑
(Relevance · Novelty · Consistency · Utility)
This isn't RAG. This isn't vector search. This is knowledge that evolves — facts get validated, promoted, consolidated, and the agent develops meta-awareness of what it knows well and what it doesn't.
🚀 Quick Start
# Install
pip install leaper-agent
# Set your API key
export OPENAI_API_KEY=sk-xxx
# or: export ANTHROPIC_API_KEY=sk-ant-xxx
# or: export GEMINI_API_KEY=xxx
# Create an agent with the CEO Coach template
leaper create my-agent --template ceo-coach
# Start
leaper start my-agent
Deploy as Telegram Bot
leaper create my-bot --template ceo-coach --bot-token YOUR_TELEGRAM_TOKEN
leaper start my-bot
🏗️ Architecture
┌─────────────────────────────────────────┐
│ Leaper Agent Runtime │
│ (Hermes-compatible agent loop) │
├─────────┬──────────┬──────────┬────────┤
│ OpenAI │ Claude │ Gemini │ Ollama │
├─────────┴──────────┴──────────┴────────┤
│ Agent Orchestration │
│ Role templates · Tool calling │
├─────────────────────────────────────────┤
│ 🧠 DeepBrain Memory Engine │
│ 6-Layer · 4-Gate · Zero Dependencies │
│ SQLite-only · 100% Local · Evolving │
└─────────────────────────────────────────┘
Key difference from Hermes: Hermes stores skills as static Markdown files. Leaper Agent's DeepBrain automatically extracts, validates, and evolves knowledge from every conversation — no manual curation needed.
⚡ Hermes Compatibility
Leaper Agent is built on the Hermes Agent foundation. If you're familiar with Hermes, you'll feel at home:
- Same agent loop architecture
- Same multi-provider model support
- Same tool runtime
- Plus: 6-layer evolving memory that Hermes doesn't have
🔌 Supported Providers
| Provider | Models | Status |
|---|---|---|
| OpenAI | GPT-4o, GPT-4o-mini, o1/o3 | ✅ |
| Anthropic | Claude Sonnet, Opus, Haiku | ✅ |
| Gemini 2.0, 2.5 | ✅ | |
| Ollama | Any local model | ✅ |
📊 vs Other Frameworks
| Leaper Agent | Hermes | CrewAI | AutoGen | LangGraph | |
|---|---|---|---|---|---|
| Memory that evolves | ✅ 6-layer | ❌ Static files | ❌ Flat KV | ❌ Chat history | ❌ Checkpoints |
| Knowledge quality control | ✅ 4-Gate | ❌ | ❌ | ❌ | ❌ |
| Meta-knowledge | ✅ | ❌ | ❌ | ❌ | ❌ |
| Multi-provider | ✅ | ✅ | ✅ | ✅ | ✅ |
| Zero memory dependencies | ✅ SQLite only | N/A | ❌ Redis/Qdrant | ❌ | ❌ Vector DB |
| Hermes compatible | ✅ | ✅ | ❌ | ❌ | ❌ |
🇨🇳 China Version / 中国版
For Chinese LLM providers (DeepSeek, 通义千问, 智谱, Moonshot) + 150 role templates:
pip install leaper-agent-cn
🔗 Ecosystem
| Project | Description |
|---|---|
| OPC DeepBrain | Standalone memory engine (use in any framework) |
| OPC Agent | Local-first agent with Ollama |
| Leaper Agent CN | China-optimized with 150 templates |
📄 License
BSL-1.1 — Free for non-competitive use. Converts to Apache-2.0 after 4 years.
🤝 Contributing
We welcome contributions! See CONTRIBUTING.md.
📧 Contact: tech@deepleaper.com
Built with ❤️ by Deepleaper Technology / 跃盟科技
Other agents forget. Leaper Agent evolves.
Project details
Release history Release notifications | RSS feed
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 leaper_agent-2.0.2.tar.gz.
File metadata
- Download URL: leaper_agent-2.0.2.tar.gz
- Upload date:
- Size: 5.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a4cd8011983b579a2afc3488d8b6936d82ea65bd249e0b620aa00460917feab9
|
|
| MD5 |
6d7ae7ead901333fdfe8fc90446a98a7
|
|
| BLAKE2b-256 |
073724c02e44bd669ada9cff9c7449b8fe7955e8017ba01fe799fa118950689a
|
File details
Details for the file leaper_agent-2.0.2-py3-none-any.whl.
File metadata
- Download URL: leaper_agent-2.0.2-py3-none-any.whl
- Upload date:
- Size: 2.8 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ec9b825860a58edc15671525d365761ae76d1fe3c42d1f19bb71de1155be5607
|
|
| MD5 |
c1aa33475db55a4a802c59b5d4877da9
|
|
| BLAKE2b-256 |
b65fe5af571d6711ab0b177746d8e59778c2b1348fa207ae5c24f78d1d1524c1
|