pulse-agent 3.0.0

Self-hosted personal intelligence agent

The self-hosted personal intelligence agent.

pulseagent.dev · Documentation · Contributing

Ingest your digital life, discover patterns, write an Obsidian-style vault, get push insights — all self-hosted.

Pulse is still experimental and in active testing, so expect some rough edges and occasional changes. It is best suited for early adopters who are comfortable self-hosting.

---

Install

Install Script

curl -fsSL https://pulseagent.dev/install.sh | bash

Pip

pipx install pulse-agent   # or: uv tool install pulse-agent

Docker

docker pull ghcr.io/jeff7712/pulse:3.0.0

docker run -d --name pulse -p 8000:8000 \
  -v pulse-config:/config -v pulse-data:/data \
  ghcr.io/jeff7712/pulse:3.0.0 pulse onboard

From a clone: docker build -t pulse -f Dockerfile . or docker compose up --build -d. Quickstart — Docker for more details.

Defaults (native install): config under ~/.config/pulse, data under ~/.local/share/pulse (override with PULSE_CONFIG_DIR). Next: pulse configure → pulse init → pulse run — see Quickstart.

Documentation

Documentation lives under docs/ in this repository, or pulseagent.dev/docs. Paths and environment: Standalone app, CLI commands, and the MCP server use PULSE_DATABASE_PATH. That variable selects the SQLite event store; use PULSE_VAULT_PATH for vault markdown. Override the config directory with PULSE_CONFIG_DIR (default finds .config/pulse.toml under ~/.config/pulse). pulse and pulse-mcp read the same variables; discovery day boundaries and related scheduling semantics are documented in the Operations runbook (PULSE_TIMEZONE).

MCP

Use pulse-mcp with Claude Code, Cursor, OpenClaw, etc. Setup, client JSON, tools, and resources: MCP agent setup.

Send this to your agent:

Read https://raw.githubusercontent.com/JEFF7712/pulse/main/docs/self-hosting/mcp-agent-setup.md and follow every step to install Pulse (pulse-agent), ensure pulse.toml exists, and register pulse-mcp in my MCP settings for this machine.

Develop

uv sync --group dev && uv run pytest

Layout and companion app: Contributing.

---

pulseagent.dev | PyPI | GitHub