Jazz documentation

Jazz is an open-source AI assistant that can read and edit files, run commands, research the web, and create documents and visuals. You choose its model and permissions, then use it in your terminal, scripts, CI, schedules, or chat apps.

Start in two minutes

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

On first run, choose Start setup to pick a model provider and create your agent. You can then ask it to inspect files, work with git, read the web, or create artifacts. See the quick start for the complete first session.

Choose what you need

• New to Jazz: install it and complete your first useful run.
• Evaluating Jazz: explore its capabilities and compare where it runs.
• Creating an agent: configure its model, persona, and tools.
• Setting up a job: follow a guide.
• Operating it safely: read the security model, and what Jazz sends over the network on its own.
• Finding what Jazz keeps on disk: the runtime data reference lists every file and directory it writes.
• Fixing something that went wrong: start with troubleshooting. Uninstalling removes everything Jazz put on the machine.

What you can do

• Work on a project: ask an agent to explore a repository, make a change, and run the checks. Agents and project instructions let you tailor it to your work.
• Finish a larger task: give Jazz a goal and a way to verify completion. It continues across turns; context management makes room as the conversation grows.
• Watch for changes: use a loop to check a deployment, or schedule a workflow for a recurring briefing or review.
• Create something you can use: ask for a PDF, generated media, or an interactive composition such as a dashboard or calculator. Results are saved as artifacts.
• Use several models together: keep your preferred main model and add companions for images, audio, or video. Delegate independent research or checks to subagents.
• Connect your tools: add MCP servers, custom tools, and skills for your own systems and procedures.
• Reach Jazz wherever you work: use the same agent in scripts and CI, chat apps, or behind a webhook. Use /detach to continue a conversation on your server.

Choose cloud or local models, set budgets, and control actions through approvals.

Exact syntax

The CLI reference lists jazz commands, subcommands, global options, and flags. For the terminal experience, read CLI. Before updating across a minor version, read Upgrading for the versioning policy and how breaking changes are announced. Configuration and tool details live under Configure and Tools.