This release is a pre-release and may not be stable for production use.
Elephant Agent
Elephants never forget.
Personal-Model-first self-evolving AI agent · Curiosity at your pace · Reflect after the turn.
Why an Elephant?
The old saying is close to true, but the beautiful part is not storage. Elephants remember with meaning.
They recognize companions by sight and smell, remember danger cues, and return to important places long after the last visit. Older matriarchs can guide a herd through hard seasons because memory has become practical judgment: who is safe, where water may be found, and which warning signs deserve attention.
That is the inspiration for Elephant Agent: memory that becomes care, context, and better judgment.
From Elephant Memory to Personal AI
Most AI still asks you to begin again. You explain the same project, the same people, the same constraints, the same decisions, and the same hard-won lessons. Longer context windows help for a while, but they do not solve the deeper problem: a personal AI should know which memories are worth carrying forward.
Elephant Agent is built around that idea. It does not try to preserve every transcript. It grows a correctable understanding of the paths, people, risks, rhythms, and decisions that should shape future help.
- It remembers less, but understands deeper.
- It picks up the right thread instead of replaying the whole past.
- It asks gently when one missing answer would change how it helps.
- It shows evidence, accepts correction, and lets silence stand.
- It becomes more yours over time because its understanding stays tied to you, not just to the current task.
This is the self-evolving part: Elephant Agent does not evolve by collecting more transcripts or blindly adding skills. It evolves around you as curiosity and background reflect jobs turn lived evidence into a clearer, correctable Personal Model.
One elephant is a durable companion for a line of work or life context. Many
elephants form a herd.
What Elephant Agent Learns
Elephant Agent is not trying to collect a complete profile. It learns what has durable value for future help:
| Lens | What it carries forward |
|---|---|
| Identity | Stable self-description, values, decision style, boundaries, and durable preferences. |
| World | Projects, people, tools, places, vocabulary, and relationships that shape your context. |
| Pulse | Current focus, active pressure, recent constraints, mood patterns, and temporary priorities. |
| Journey | Past experiences, lessons, failures, recovery patterns, and long-running growth. |
That learning comes from four loops:
- Grounded learning from explicit remembers, corrections, and dashboard edits.
- Curiosity-driven learning from one useful question when a gap would change future help.
- Reflect-driven background learning from agents that read Episode steps after close, idle, diary, or manual triggers.
- Skill fit learning from visible capability use while keeping durable understanding inspectable.
Curiosity, At Your Pace
At elephant init, you choose how curious your Elephant Agent should be:
| Curiosity effort | What it feels like |
|---|---|
| Quiet | Elephant Agent mostly waits and asks rarely. |
| Balanced | Elephant Agent asks at natural pauses when the answer would help. |
| Active | Elephant Agent is more willing to check in and learn, while staying optional. |
Every question belongs to a Personal Model lens and exists for a reason: a gap, a conflict, a stale pulse, or an adaptation that would improve future help. Questions are visible and dismissible. Silence always wins.
You stay in control
Open the dashboard to see and shape what Elephant Agent understands:
- You — active Identity, World, Pulse, and Journey claims.
- Why — evidence behind a claim, shown when you inspect it.
- Questions — open, asked, answered, and dismissed curiosity prompts.
- Evidence — the trail behind understanding, not hidden prompt truth.
You can correct or forget claims, answer or dismiss questions, and keep Elephant Agent’s understanding aligned with who you are now.
Quickstart
Install Elephant Agent, create your first named elephant, then come back through wake whenever
you want to continue.
Install
curl -fsSL https://elephant.agentic-in.ai/install.sh | bash
First run
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
How It Deepens
| Day 1 | Week 1 | Month 1 | Month 3 |
|---|---|---|---|
| It knows your first anchors | It knows the project and people in view | It asks better questions and explains why | It has grown into your rhythms, with evidence you can inspect |
Paper and blog
README and the homepage stay product-first. The deeper system story lives here:
Contributors
Agentic Intelligence Lab
Metadata
Release files for elephant-agent 1.0.0.dev20260522025801
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| elephant_agent-1.0.0.dev20260522025801.tar.gz | 4.1 MB | Without provenance | Details for elephant_agent-1.0.0.dev20260522025801.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| elephant_agent-1.0.0.dev20260522025801-py3-none-any.whl | Python 3 | none | any | Details for elephant_agent-1.0.0.dev20260522025801-py3-none-any.whl |
Total release size: 8.5 MB
Release files / elephant_agent-1.0.0.dev20260522025801.tar.gz
| Download URL | elephant_agent-1.0.0.dev20260522025801.tar.gz |
|---|---|
| Size | 4.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
872fe7176e5263e57b60dfc8b7f89c20ac28277a65523cb7882297d2871dfd43
|
|
BLAKE2b-256 checksum How to use checksums |
dabc6d3a3fa22ba24360c477d9dd1ec31cf109ca8f2e99f49e6cee26572501d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / elephant_agent-1.0.0.dev20260522025801-py3-none-any.whl
| Download URL | elephant_agent-1.0.0.dev20260522025801-py3-none-any.whl |
|---|---|
| Size | 4.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a9c6acd2eb5da59a7fb34d1a13ad4ba485fce3887eb53f5858f061849db0c82d
|
|
BLAKE2b-256 checksum How to use checksums |
fcb40125bcd9118c6bff8a2231b15e7c2dcb68889bde1efdddf794bdc18ab12b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Security for elephant-agent 1.0.0.dev20260522025801
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.