Skip to main content

Elephant Agent CLI-first persistent agent runtime.

Project description

Elephant Agent follows a personal path with people, places, risks, rhythms, decisions, and a Personal Model

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

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

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.dev20260526090952.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.dev20260526090952.tar.gz.

File metadata

File hashes

Hashes for elephant_agent-1.0.0.dev20260526090952.tar.gz
Algorithm Hash digest
SHA256 340ccc5faac9bfe6df7500cb3f2efc44f61a1510c4818c7adadae2b59634e87d
MD5 c67b02cae2981f375135f0e8eb4aa74f
BLAKE2b-256 3f4cfe418e3a5d9f13198f77f350d6950c01dc2178f2cd5e59c6aa17782b31ba

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for elephant_agent-1.0.0.dev20260526090952-py3-none-any.whl
Algorithm Hash digest
SHA256 2680eb1fb90c39860576df2def4a9435a929368af8638e7556048eac993fad6a
MD5 3c21bb2477f486898a32491e0e198835
BLAKE2b-256 52c42e1e4f2a3bafa07d86a5d2c6621f7292dda61072375d0c24af923ebb107d

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