Elephant Agent CLI-first persistent agent runtime.
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file elephant_agent-1.0.0.dev20260526100228.tar.gz.
File metadata
- Download URL: elephant_agent-1.0.0.dev20260526100228.tar.gz
- Upload date:
- Size: 1.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1665dba2ae6bc607a4ccd6d963405333d0b5489f50fa2702e8e15fa277b6223d
|
|
| MD5 |
4186c6ade5c868c333cfd736c0a713c9
|
|
| BLAKE2b-256 |
7b9955e4e17a83aed79482888a047266ae443b63123d9782f1e3ac057e22bbfe
|
File details
Details for the file elephant_agent-1.0.0.dev20260526100228-py3-none-any.whl.
File metadata
- Download URL: elephant_agent-1.0.0.dev20260526100228-py3-none-any.whl
- Upload date:
- Size: 1.8 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
70d98e2158c184f903c91041fc34038d91174bd10fc0b3f2aa99c707115c36a7
|
|
| MD5 |
452ba18501e71a32d2a378eb826b7d5d
|
|
| BLAKE2b-256 |
8284e7f6c00f96c0cedb0d5062a5f1c6307beae7d1a070d7751e158590e0ff66
|