Skip to main content

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

Project description

🚀 Leaper Agent

Self-Evolving AI Agent Framework — Multi-Provider, Multi-Agent, with Built-in Memory

自进化 AI Agent 框架 — 多模型、多智能体、内置记忆引擎

PyPI version Downloads GitHub stars License Python

Website · Quick Start · Features · 中国版


✨ Why Leaper Agent?

Most agent frameworks treat every conversation as a blank slate. Leaper Agent is different — it learns from every interaction and gets smarter over time, powered by DeepBrain's 6-layer self-evolving memory.

Built on top of Hermes Agent, enhanced with persistent memory, multi-agent orchestration, and production-ready integrations.

🎯 Features

  • 🧠 Self-Evolving Memory — DeepBrain 6-layer memory: your agent remembers, consolidates, and evolves
  • 🔌 Multi-Provider — OpenAI, Anthropic Claude, Google Gemini, and more. Switch with one line
  • 🤝 Multi-Agent — Orchestrate multiple agents with different roles and specialties
  • 🤖 Telegram Integration — Deploy as a Telegram bot in minutes
  • 🎭 Role Templates — Pre-built personas (CTO, Analyst, Writer…) or create your own
  • 🔧 MCP Support — Model Context Protocol for tool/plugin extensibility
  • 📡 Streaming — Real-time streaming responses out of the box

🚀 Quick Start

# 1. Install
pip install leaper-agent

# 2. Set your API key (pick one)
export OPENAI_API_KEY=sk-xxx
# or: export ANTHROPIC_API_KEY=sk-ant-xxx
# or: export GEMINI_API_KEY=xxx

# 3. Initialize
leaper-agent init

# 4. Chat!
leaper-agent chat

As a Telegram Bot

export TELEGRAM_BOT_TOKEN=your-token
leaper-agent serve --telegram

Multi-Agent Setup

from leaper_agent import Agent, Team

researcher = Agent(role="researcher", provider="openai", model="gpt-4o")
writer = Agent(role="writer", provider="anthropic", model="claude-sonnet-4-20250514")

team = Team(agents=[researcher, writer])
result = team.run("Research and write an article about quantum computing")

🏗️ Architecture

┌─────────────────────────────────────────┐
│           Leaper Agent Core             │
├─────────┬──────────┬───────────────────┤
│ OpenAI  │ Claude   │ Gemini  │ ...     │
├─────────┴──────────┴───────────────────┤
│         Role Templates & Tools          │
├─────────────────────────────────────────┤
│         Multi-Agent Orchestration       │
├─────────────────────────────────────────┤
│         🧠 DeepBrain Memory Engine      │
│    6-Layer Self-Evolving Knowledge      │
│    ┌──────────────────────────────┐     │
│    │  4-Gate Quality Control      │     │
│    │  Relevance → Novelty →       │     │
│    │  Consistency → Utility       │     │
│    └──────────────────────────────┘     │
└─────────────────────────────────────────┘

🔌 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

🎭 Built-in Role Templates

# Use a pre-built role
leaper-agent chat --role cto
leaper-agent chat --role analyst
leaper-agent chat --role writer

# Create your own
leaper-agent role create my-role

🧠 Memory in Action

from leaper_agent import Agent

agent = Agent(provider="openai", model="gpt-4o", memory=True)

# Session 1
agent.chat("My name is Ray, I'm building an AI startup")

# Session 2 — agent remembers!
agent.chat("What's my name?")  # → "Your name is Ray..."

🇨🇳 China Version / 中国版

For users in China with Chinese LLM providers (通义千问、DeepSeek、文心一言):

pip install leaper-agent-cn

Leaper Agent CN

📄 License

BSL-1.1 — see LICENSE for details.

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md.

📧 Contact: tech@deepleaper.com


Built with ❤️ by Deepleaper Technology / 跃盟科技

Agents that learn. Agents that evolve. Agents that remember.

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.1.tar.gz (5.8 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.1-py3-none-any.whl (2.7 MB view details)

Uploaded Python 3

File details

Details for the file leaper_agent-2.0.1.tar.gz.

File metadata

  • Download URL: leaper_agent-2.0.1.tar.gz
  • Upload date:
  • Size: 5.8 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.1.tar.gz
Algorithm Hash digest
SHA256 86af09fdf79c1b5b10f55ca200f78fac3b2526abe6ac5f24291465e0ecde83d7
MD5 598d4e32f0b1b2a69f26bfc3d3f5da58
BLAKE2b-256 9a062cb3b1eb748f3ba15f2dba701326a3fc4e1950fa9455d69c67cf36af41ed

See more details on using hashes here.

File details

Details for the file leaper_agent-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: leaper_agent-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 2.7 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0056113a6c9ead56d39bd56b388fec58d65edabf2a58888cecc7a46905093f41
MD5 54cbcb51c9f60b662374482ebb930614
BLAKE2b-256 b60b8a395bfa928bfe9f8a3506d6b28fa1e9edc0cbf3fe9ad40659ab09fb195d

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