🤙 yeaboi.ai
Best friend to engineers and agents — plans, standups, retros, performance & reporting for your team, plus cost, recoverable spend and security posture for the AI agents working alongside it. All from your terminal.
One command: your team's whole scrum, from the plan to the report.
🚀 Quick Start
Install (it brings its own Python)
curl -LsSf https://yeaboi.ai/install.sh | sh
yeaboi --setup # configure your API key
yeaboi # launch the interactive TUI
You do not need to install Python first. The script installs uv
if it is missing, then gives yeaboi its own isolated environment on a Python that uv downloads —
so whatever is (or isn't) on your machine does not matter. It writes only under your home
directory and never uses sudo. Read it first if you like: install.sh.
macOS and Linux. On Windows, install inside WSL — the terminal UI needs a POSIX terminal.
Other ways to install
uv tool install yeaboi # already have uv
uvx yeaboi # try it without installing
pipx install --python 3.12 --fetch-missing-python yeaboi
pip install yeaboi # needs Python 3.10+ already present
uv tool install fetches a Python for you if none on the machine qualifies. pipx and pip
do not — they use the interpreter they are run with, which is why the flags above are needed
and why the curl line is the one to give someone who just wants to see the product.
uvx yeaboi runs without installing anything permanent; your API key and sessions still live in
~/.yeaboi, so yeaboi --setup persists across runs.
Note on names: the package was previously published as
scrum-agent. It is nowyeaboion PyPI, matching the command. A finalscrum-agentrelease remains as a thin redirect that installsyeaboi, and the legacyscrum-agentcommand still works as an alias for that release — but new installs should useyeaboi.
Voice input needs no separate install. Double-tap Space in any text field and yeaboi
offers to set dictation up in place — it installs the packages into the environment it is
already running in, downloads the speech model with a progress bar, and drops straight
into recording. No restart, no second terminal. (yeaboi --install-voice does the same
thing headlessly, for CI and dev containers.)
It is kept out of the base install rather than bundled because the speech engine
(ctranslate2, onnxruntime) publishes wheels only for 64-bit macOS, glibc ≥ 2.28 Linux
and Windows — making it a hard dependency would break pip install yeaboi outright on
Alpine/musl, older glibc, 32-bit and armv7 hosts. On those platforms yeaboi says so
instead of offering an install that cannot work.
Optional extras can still be requested at install time if you prefer:
uv tool install "yeaboi[voice]" # 🎤 dictation, pre-installed rather than on demand
uv tool install "yeaboi[all-providers]" # OpenAI, Google, Bedrock, Ollama + the six OpenAI-wire vendors
pipx install --python 3.12 --fetch-missing-python "yeaboi[voice]" # equivalent with pipx
Voice input transcribes on-device with faster-whisper — no API key, works with every LLM provider (Anthropic, Bedrock, …). On macOS/Windows it is fully self-contained (the
sounddevicewheel bundles PortAudio). On Linux, also install the system library:sudo apt install libportaudio2— yeaboi will not runsudofor you. A small Whisper model downloads on first use (~140 MB for the defaultbase; setVOICE_MODELtotiny/small/medium/large-v3to trade size for accuracy).
Homebrew is not supported. A required dependency (
sqlite-vec) ships no source distribution, which Homebrew's source-build model can't handle, sobrew install yeaboiis intentionally disabled. Use thecurlline oruv tool installabove instead.
From source
git clone https://github.com/yeaboi-ai/yeaboi.ai.git
cd yeaboi.ai
make install # installs uv, creates venv, installs dependencies
make env # creates .env from .env.example — add your API key
make run # launch the CLI
Headless / CI mode
yeaboi --non-interactive --description "Build a todo app" --output json
yeaboi --non-interactive --description @project-brief.txt --output html --team-size 5
✨ Features
🖥️ Full-screen TUI — Animated splash, mode selection, pipeline progress, dark/light themes 🧠 Smart Intake — Extracts answers from your project description, asks only what's missing — or feed it a whole quarterly roadmap with Roadmap Intake 🔄 Seven modes, one command — Planning, Daily Standup, Retro, Planning Poker, Performance (beta), Reporting, Team Analysis 🔌 37 tools — GitHub, Azure DevOps, Jira, Confluence, Notion, local codebase scanning, and more 📤 5 export formats — Markdown, HTML, JSON, Jira sync, Azure DevOps Boards sync 🤖 11 LLM providers — Claude (default), GPT, Gemini, Grok, DeepSeek, Kimi, Mistral, Qwen, GLM, AWS Bedrock, or fully local & keyless with Ollama 🧩 Every surface — TUI, CLI subcommands, MCP server, and a Claude Code plugin, with feature parity enforced in CI 💾 Session persistence — SQLite-backed sessions plus a saved-runs hub for past standups, retros, and reports 🛡️ Guardrails — Input/output validation, human-in-the-loop review at every stage
📖 Full Documentation
Getting started, the full CLI reference, every mode in depth, integrations, architecture, and deployment guides: yeaboi.ai/docs
📄 License
MIT License. See LICENSE for details.
1 maintainer
Metadata
1 maintainer
Release files for yeaboi 4.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yeaboi-4.0.0.tar.gz | 5.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yeaboi-4.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.0 MB
Release files / yeaboi-4.0.0.tar.gz
| Download URL | yeaboi-4.0.0.tar.gz |
|---|---|
| Size | 5.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
775c71592fc7c4a9958af0f4b86780285d7640ae436eabe81783a222556f603f
|
|
BLAKE2b-256 checksum How to use checksums |
e0bc1c3693fc3c7c268e8f4d16f4e548f80e2379b53ab64a7440d1bbe37bacea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency logRelease files / yeaboi-4.0.0-py3-none-any.whl
| Download URL | yeaboi-4.0.0-py3-none-any.whl |
|---|---|
| Size | 3.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
333a0852965be93211527c280bd3d15ef5decd344e8c5f9e20665e31ae7e8396
|
|
BLAKE2b-256 checksum How to use checksums |
95b3239359d312d398bd4b1cb46613e95b1458faffa517623aba2ca97ceb1b8f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency log
