This release is a pre-release and may not be stable for production use.
Elephant Agent
Agency-first personal AI.
A correctable Personal Model for Identity, World, Pulse, and Journey.
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 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 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.
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
Elephant Agent has two supported product shapes.
1. macOS desktop app (recommended)
Use this path for the full local desktop workspace: Wake, You, Diary, Reflect, Jobs, Skills, Settings, and the Personal Model map in one native app.
- Download the latest macOS build from GitHub Releases.
- Open
Elephant Agent.app. - Create your first elephant, choose a provider, and set curiosity effort.
- Return through Wake when you want to continue the same path.
2. CLI + Dashboard (Linux / Cloud)
Use this path for Linux, cloud machines, SSH workflows, and terminal-first operators. The CLI is the daily work surface; the Dashboard is the visual inspection surface for Personal Model, evidence, jobs, skills, and runtime state.
Install:
curl -fsSL https://elephant.agentic-in.ai/install.sh | bash
First run:
elephant init # choose identity, provider, and curiosity effort
elephant status # check provider and local runtime readiness
elephant wake # enter the chat TUI
elephant dashboard # open You, Questions, and Evidence
For remote or cloud use, elephant dashboard --no-open prints the local URL so
you can attach through your preferred tunnel or browser setup.
Read More
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.dev20260526100228
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.dev20260526100228.tar.gz | 1.6 MB | Without provenance | Details for elephant_agent-1.0.0.dev20260526100228.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| elephant_agent-1.0.0.dev20260526100228-py3-none-any.whl | Python 3 | none | any | Details for elephant_agent-1.0.0.dev20260526100228-py3-none-any.whl |
Total release size: 3.4 MB
Release files / elephant_agent-1.0.0.dev20260526100228.tar.gz
| Download URL | elephant_agent-1.0.0.dev20260526100228.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1665dba2ae6bc607a4ccd6d963405333d0b5489f50fa2702e8e15fa277b6223d
|
|
BLAKE2b-256 checksum How to use checksums |
7b9955e4e17a83aed79482888a047266ae443b63123d9782f1e3ac057e22bbfe
|
| 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.dev20260526100228-py3-none-any.whl
| Download URL | elephant_agent-1.0.0.dev20260526100228-py3-none-any.whl |
|---|---|
| Size | 1.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
70d98e2158c184f903c91041fc34038d91174bd10fc0b3f2aa99c707115c36a7
|
|
BLAKE2b-256 checksum How to use checksums |
8284e7f6c00f96c0cedb0d5062a5f1c6307beae7d1a070d7751e158590e0ff66
|
| 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.dev20260526100228
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.