Jazz

One agent. Every surface. Your rules.

Jazz is a general-purpose AI agent that runs on your own machine. Not just for code: use it for email, research, planning, and automation.

Install it once and it runs everywhere. A terminal REPL, a one-shot command inside a script, a scheduled workflow, a GitHub Action that reviews your pull requests, or a Telegram and Discord bot on a server you own. Same agent, same tools, same memory. When a job needs your permission it asks you wherever you are, rather than stopping.

18 providers are supported, including OpenAI, Anthropic, Google, Mistral, Groq, and OpenRouter, plus ollama and llama.cpp for local models with no API key. Everything else connects through MCP.

Get started

curl -fsSL https://github.com/lvndry/jazz/releases/latest/download/install.sh | bash
jazz

That installs a single self-contained binary into ~/.local/bin — no Node, no npm, nothing else to install. Set JAZZ_INSTALL_DIR to put it somewhere else. If you would rather go through npm:

npm install -g jazz-ai
jazz

Either way, jazz update upgrades in place.

Jazz walks you through provider setup on first run. It can cost nothing: OpenRouter's free models router needs no credit card, and ollama runs entirely on your own hardware.

Then ask it for what you want:

> check my unread email, summarize what matters, archive the rest
> deep-research the Three-Body Problem and write it into my Obsidian vault
> every morning at 7, tell me the weather and what to wear
> review the last 5 commits and flag anything risky

Where it runs

Slack, Google Chat, or your own app work the same way. See Chat platforms.

Documentation

Start at docs/index.md.

• Quick start and creating agents
• Cookbook, ready-made workflows to copy
• Skills, tools, and workflows
• Safety and approvals
• Headless runs, the contract behind every surface
• Airgapped and self-hosted
• CLI and configuration reference
• Design decisions, why it is built this way

Community

Discord · Discussions · Issues · Contributing · Security

MIT licensed. See LICENSE.