Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.

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

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)

Source distribution for elephant-agent 1.0.0.dev20260526100228
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)

Table of built distributions (wheels) for elephant-agent 1.0.0.dev20260526100228
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page