Skip to main content

自进化 AI 员工框架 — 越用越聪明

Project description

🚀 Leaper Agent

The Agent Framework That Actually Remembers

Hermes-Compatible Agent Orchestration + DeepBrain 6-Layer Evolving Memory

PyPI version Downloads GitHub stars License Python

Website · Quick Start · Why Memory Matters · 中国版


🤔 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
Google 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

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


Download files

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

Source Distribution

leaper_agent-2.0.2.tar.gz (5.9 MB view details)

Uploaded Source

Built Distribution

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

leaper_agent-2.0.2-py3-none-any.whl (2.8 MB view details)

Uploaded Python 3

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

Hashes for leaper_agent-2.0.2.tar.gz
Algorithm Hash digest
SHA256 a4cd8011983b579a2afc3488d8b6936d82ea65bd249e0b620aa00460917feab9
MD5 6d7ae7ead901333fdfe8fc90446a98a7
BLAKE2b-256 073724c02e44bd669ada9cff9c7449b8fe7955e8017ba01fe799fa118950689a

See more details on using hashes here.

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

Hashes for leaper_agent-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ec9b825860a58edc15671525d365761ae76d1fe3c42d1f19bb71de1155be5607
MD5 c1aa33475db55a4a802c59b5d4877da9
BLAKE2b-256 b65fe5af571d6711ab0b177746d8e59778c2b1348fa207ae5c24f78d1d1524c1

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