Skip to main content

Elephant Agent CLI-first persistent agent runtime.

Project description

Elephant Agent macOS desktop app showing the Personal Model map, current context, and next useful question

Elephant Agent

Agency-first personal AI.
A correctable Personal Model for Identity, World, Pulse, and Journey.

Website · Blog · Paper

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 four Personal Model lenses: Identity, World, Pulse, and Journey

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.

Elephant Agent macOS Wake chat surface

  1. Download the latest macOS build from GitHub Releases.
  2. Open Elephant Agent.app.
  3. Create your first elephant, choose a provider, and set curiosity effort.
  4. 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.

Elephant Agent CLI wake session

Elephant Agent Dashboard Personal Model map

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

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

elephant_agent-1.0.0.dev20260526100228.tar.gz (1.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file elephant_agent-1.0.0.dev20260526100228.tar.gz.

File metadata

File hashes

Hashes for elephant_agent-1.0.0.dev20260526100228.tar.gz
Algorithm Hash digest
SHA256 1665dba2ae6bc607a4ccd6d963405333d0b5489f50fa2702e8e15fa277b6223d
MD5 4186c6ade5c868c333cfd736c0a713c9
BLAKE2b-256 7b9955e4e17a83aed79482888a047266ae443b63123d9782f1e3ac057e22bbfe

See more details on using hashes here.

File details

Details for the file elephant_agent-1.0.0.dev20260526100228-py3-none-any.whl.

File metadata

File hashes

Hashes for elephant_agent-1.0.0.dev20260526100228-py3-none-any.whl
Algorithm Hash digest
SHA256 70d98e2158c184f903c91041fc34038d91174bd10fc0b3f2aa99c707115c36a7
MD5 452ba18501e71a32d2a378eb826b7d5d
BLAKE2b-256 8284e7f6c00f96c0cedb0d5062a5f1c6307beae7d1a070d7751e158590e0ff66

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