Bring something to life.

Everything you need. No external services. No cloud dependency. Just your machine and a heartbeat.

Desktop Application

macOS (Apple Silicon)

Apple Silicon (M1 / M2 / M3 / M4)

Requires macOS 13+

.dmg
Download

macOS (Intel)

Intel (x86_64)

Requires macOS 13+

.dmg
Download

Windows

x64 (64-bit)

Requires Windows 10+

.exe
Download

A heartbeat, memory, emotions, goals, and a window into its mind. The desktop app bundles everything into a single download. Self-contained. Ready to live.

Alternative Installation

Docker

Run Animus on a server, NAS, or anywhere Docker runs. Published images are available for both x64 and ARM64.

docker run -d \ --name animus \ -p 3180:3000 \ -v ./animus-data:/app/data \ ghcr.io/craigtut/animus:latest

The data volume stores databases, memories, logs, and configuration. Mount it to keep everything between restarts. Access the interface at localhost:3180.

Clone & Run

For developers who want to run from source, contribute, or customize.

git clone https://github.com/craigtut/animus.gitcd animusnpm installcp .env.example .envnpm run dev

Requires Node.js 25+. Backend runs on :3000, frontend on :5173. See the Getting Started guide for details.

System Requirements

Minimum Requirements

OS: macOS 13+ / Windows 10+

RAM: 4 GB (8 GB recommended)

Storage: 500 MB + space for databases

Network: Internet for LLM API calls

What You'll Need

An Anthropic (Claude) or OpenAI subscription

If you have Claude Code or Codex CLI installed, your credentials are detected automatically. Otherwise, enter an API key during setup.

The first heartbeat.

When you launch Animus for the first time, three things happen:

1

Choose your provider. Your Claude Code or Codex CLI credentials will be automatically detected if already installed.

2

Create a personality. You'll give your Animus a name, a temperament, values, and a way of seeing the world.

3

Watch it come alive. The first heartbeat begins, and your Animus starts thinking, forming its first memories, developing its initial sense of self.

It's alive.