Metadata-Version: 2.4
Name: elephant-agent
Version: 1.0.0.dev20260526090952
Summary: Elephant Agent CLI-first persistent agent runtime.
Author: Agentic Intelligence Lab
Project-URL: Homepage, https://elephant.agentic-in.ai
Project-URL: Documentation, https://elephant.agentic-in.ai/docs/
Project-URL: Repository, https://github.com/agentic-in/elephant-agent
Project-URL: Issues, https://github.com/agentic-in/elephant-agent/issues
Keywords: elephant-agent,personal-ai,agent,cli,persistent-ai,memory,automation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: aiohttp<4,>=3.9
Requires-Dist: cryptography<45,>=42
Requires-Dist: dingtalk-stream>=0.24.0
Requires-Dist: discord.py<3,>=2.6
Requires-Dist: opentelemetry-api<2,>=1.41
Requires-Dist: opentelemetry-sdk<2,>=1.41
Requires-Dist: opentelemetry-semantic-conventions<1,>=0.52b0
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2,>=1.41
Requires-Dist: prompt_toolkit<4,>=3.0
Requires-Dist: qrcode<9,>=7
Requires-Dist: rich<15,>=13
Requires-Dist: typer<1,>=0.16
Requires-Dist: lark-oapi<2,>=1.5.3
Requires-Dist: mcp<2,>=1.12
Requires-Dist: playwright<2,>=1.51
Requires-Dist: sqlite-vec==0.1.9
Requires-Dist: tiktoken<1,>=0.7

<p align="center">
  <img src="apps/site/static/assets/resources/readme-1.png" alt="Elephant Agent follows a personal path with people, places, risks, rhythms, decisions, and a Personal Model" width="920" />
</p>

<div align="center">
  <h1>Elephant Agent</h1>
  <p>
    <strong>Agency-first personal AI.</strong><br />
    A correctable Personal Model for Identity, World, Pulse, and Journey.
  </p>
  <p>
    <a href="https://elephant.agentic-in.ai/">Website</a>
    ·
    <a href="https://elephant.agentic-in.ai/blog/personal-ai-you-create/">Blog</a>
    ·
    <a href="https://elephant.agentic-in.ai/paper/">Paper</a>
  </p>
</div>


## What It Is

Elephant Agent is **agency-first personal AI**.

It keeps one durable object at the center: a correctable, evidence-backed
**Personal Model** of what should shape future help. Tools, skills, memory,
messaging, cron jobs, and background learning orbit that model instead of
replacing it.

The product position is **L4 personal AI**: agents may do more work, but the
person should not lose judgment, continuity, or growth in the process.

## Personal Agent Levels

| Level | Core question | Public examples | Elephant stance |
|---|---|---|---|
| **L1 — Do work** | Can AI execute tasks? | Claude Code, Cursor, Devin, Codex-style agents. | Useful capability, not the center. |
| **L2 — Carry context** | Can the agent stop starting over? | [OpenClaw](https://openclaw.ai/) publicly emphasizes local agents, persistent memory, full system access, skills, plugins, and integrations. | Required foundation; memory supports the Personal Model. |
| **L3 — Improve procedures** | Can the agent evolve skills and workflows? | [Hermes Agent](https://hermes-ai.net/) publicly positions itself around a self-improving learning loop, skill creation, recall, and user modeling. | Important downstream layer; skills stay visible and governed. |
| **L4 — Grow the person** | Can personal AI return judgment, evidence, questions, and reflection to the user? | Elephant Agent's product position. | The Personal Model should help the person do more without thinking less. |

## Personal Model

- **Identity** — who you are, your values, boundaries, decision style, and stable preferences.
- **World** — the people, projects, tools, places, and relationships around you.
- **Pulse** — what is alive right now: focus, pressure, constraints, energy, and priorities.
- **Journey** — what your path has taught: lessons, failures, recovery patterns, and long-running growth.

<p align="center">
  <img src="apps/site/static/assets/resources/readme-2.png" alt="The four Personal Model lenses: Identity, World, Pulse, and Journey" width="68%" />
</p>

The goal is not to remember everything. The goal is to understand what matters,
show why it matters, and let you change it.

## What It Does

| Capability | What it means |
|---|---|
| **Correctable claims** | Remember, correct, forget, dispute, and inspect why a claim exists. |
| **Evidence-backed recall** | Conversation search and embeddings provide support, but retrieved text does not become truth by itself. |
| **User-paced curiosity** | Quiet, balanced, or active questions appear only when an answer would improve future help. Silence wins. |
| **Background reflect** | Episode-close, diary, dream, and manual jobs turn lived Steps into governed Personal Model updates. |
| **Visible skills and tools** | Skills, tools, models, messaging, and cron jobs remain inspectable capabilities around the Personal Model. |

If Elephant Agent cannot find reliable Personal Model support, `no_match` is a
feature, not a failure.

## Quickstart

Install Elephant Agent, create your first named elephant, then come back through `wake` whenever
you want to continue.

### Install

```bash
curl -fsSL https://elephant.agentic-in.ai/install.sh | bash
```

### First run

```bash
elephant init        # choose identity, provider, and curiosity effort
elephant herd new    # create another named elephant when you need one
elephant wake        # enter the chat TUI
elephant dashboard   # open You, Questions, and Evidence
```

## Read More

README and the homepage stay product-first. The deeper system story lives here:

- [Read the docs →](https://elephant.agentic-in.ai/docs/)
- [Read the paper →](https://elephant.agentic-in.ai/paper/)
- [Read the blog →](https://elephant.agentic-in.ai/blog/personal-ai-you-create/)

## Contributors

<p align="center">
  <img src="docs/paper/assets/agentic-intelligence-lab-lockup.png" alt="Agentic Intelligence Lab" width="320" />
</p>

<p align="center">
  <bold>
    Agentic Intelligence Lab
  </bold>
</p>
