Skip to main content

Download Bodega One Code

Local-first AI desktop. Full IDE, AI chat, autonomous coding agent. Your data stays on your machine. Free for everyone while we're in beta.

Open beta · Free for everyone · Expect rough edges

This is a beta

It works, and it's free to use, for personal and commercial work alike. But it's not a finished 1.0. You will hit bugs and rough edges. When you do, tell us on Discord or open a GitHub issue. We ship fixes fast and read everything.

Recommended · Windows

One PowerShell command. No SmartScreen warning.

Open PowerShell (Win + X → Terminal), paste this, hit Enter. It grabs the portable build, checks its SHA-256 against GitHub, unpacks it to %LOCALAPPDATA%\BodegaOne and adds a Start Menu shortcut. No admin rights, no installer dialog, no warning. Run the same command again to upgrade.

irm https://bodegaone.ai/install.ps1 | iex

The script uses Microsoft's documented Unblock-File cmdlet to strip the Mark-of-the-Web that triggers SmartScreen. Read it first if you want: install.ps1 source.

Alternative · Windows installer

Prefer a traditional installer?

Heads up

Windows SmartScreen will warn you when you run this. We're shipping unsigned for the beta. EV code-signing is in progress.

When you see "Windows protected your PC", click More info then Run anyway. This is normal for indie software in early access.

Download for Windows

Windows 10+ · 64-bit · ~160 MB

It installs for your user account only, so there's no admin prompt, and later updates install without one too. Click Install, wait for the bar, then Launch Bodega One. Have an older all-users copy? Setup removes it once (one admin prompt, your data is kept).

On a locked-down or corporate machine? Grab the portable zip (~215 MB). No installer, runs from anywhere.

macOS

macOS DMG

Two builds. Pick by your Mac's chip. Signed and notarized with our Apple Developer ID. Drag to Applications, open. Standard macOS install, no Gatekeeper warnings.

macOS 12+ · ~180 MB. Apple Silicon = any M-series chip (most Macs since late 2020). Intel = pre-2020 Macs.

Linux

Linux AppImage

Single-file portable. Works on most modern Linux distros (Ubuntu 22.04+, Debian 12+, Fedora 38+, RHEL/Rocky/AlmaLinux 9+, Arch, openSUSE, Mint, Pop!_OS). CentOS 7 and 8 are end-of-life and not supported. Two builds. Pick by your CPU architecture.

x64 = standard Intel/AMD desktops + servers. ARM64 = Raspberry Pi 5, Apple Silicon Linux VMs, AWS Graviton, Asahi Linux.

Then run

chmod +x Bodega-One-*.AppImage && ./Bodega-One-*.AppImage

Prefer a package? Grab the .deb for amd64 or arm64.

AppImage ~195 MB · .deb ~140 MB

Command line · All platforms

Prefer the terminal? Get the CLI.

Bodega One Code ships a terminal client too: the same local-first agent with QEL-verified edits and air-gap mode, driven from your shell as an interactive TUI or fully headless. It shares one brain with the desktop app, so your providers, MCP servers, and sessions carry over. Bring your own model. It carries its own runtime, so there's nothing else to install.

macOS / Linux

curl -fsSL https://bodegaone.ai/cli.sh | sh

Windows (Scoop, recommended)

scoop install https://github.com/BodegaoneAI/bodegaone-cli-releases/releases/latest/download/bodega.json

Windows (PowerShell one-liner)

irm https://bodegaone.ai/cli.ps1 | iex

Homebrew users can install from the bodega.rb formula on the release. bodega self-update tells you when a new version is out but never swaps the binary behind your back: re-run the installer, or let Scoop or Homebrew upgrade it. Read the CLI docs or browse all CLI releases.

Your first 10 minutes

  1. Install and launchUse the one-liner or the installer for your platform above. The app makes no outbound request until setup is done.
  2. Pick how to run itThe first screen asks how you want to run it: on this computer, with a cloud key, or offline only. While you decide it only looks at this machine (a running Ollama or LM Studio, your GPU, keys you already saved) and preselects a sensible default. Nothing leaves the machine until you press Continue.
  3. Get a modelOn this computer: it uses a provider that is already running, or installs Ollama or the built-in llama.cpp engine for you. Downloads show their size first. Cloud key: paste your own, it gets checked against the provider. Offline only: air-gap turns on first, then it offers models already on disk, including any .gguf file you point it at.
  4. Open a project and put the agent to workThe last setup screen can open a folder, bring settings over from VS Code or Cursor, and run a 5-step tour. Start with something small and reviewable. Every change lands as a diff with a QEL verification score.
  5. Flip on air-gap any timeSettings → Privacy & Safety. Outbound connections are blocked, enforced in the app, and an Air-Gap badge stays in the top bar while it is on.

Beta builds also ask for your email on an activation screen. It puts you on the beta mailing list, and air-gap mode blocks it.

The full walkthrough lives in the Getting Started docs.

System requirements

The app itself is light. The real hardware question is which AI model you run, and that is your call: local models need VRAM, cloud models need an API key and nothing else.

AreaRequirements
WindowsWindows 10 or 11, 64-bit. ~160 MB installer. Desktop control (the agent using other apps) is Windows-only and off until you turn it on.
macOSmacOS 12 or later. Apple Silicon or Intel, separate builds for each. Signed and notarized. ~180 MB download.
LinuxUbuntu 22.04+ or a similar modern distro. x64 or ARM64. AppImage ~195 MB, .deb ~140 MB.
Memory8 GB RAM minimum. 16 to 32 GB for comfortable agent runs with mid-size local models.
Disk10 GB free minimum, 50 GB recommended. Local models are the big part.
GPUNone required. CPU-only works with 1-4B models. For mid-size models, an NVIDIA card with 8+ GB VRAM.
InternetNot required. Offline only works from the first launch.
RuntimeElectron 43. No usage analytics. Diagnostics stay on your disk.

Running models locally? Size your hardware to the model with the VRAM calculator, or skip the question entirely with a cloud API key.

Updates and uninstalling

  • Updates wait for you. Installed builds check a few seconds after launch and every four hours, then download in the background. Nothing installs until you click Restart to update. Later means later, and quitting does not install it. If a run is going, the restart waits for it.
  • Air-gap means no update checks. Grab new builds from this page by hand. The CLI updates separately.
  • Uninstalling keeps your data by default. The Windows uninstaller only removes your chats, memory and downloaded models if you tick "Also remove my Bodega One data". Your projects and workspace folder are never deleted. On macOS and Linux, remove the app, then delete ~/Library/Application Support/Bodega One or ~/.config/Bodega One if you want it all gone. Used the one-liner? Delete %LOCALAPPDATA%\BodegaOne to remove the app. Your data lives in %APPDATA%\Bodega One.

Verify your download

Every installer is hashed by GitHub when we publish it. Compare the SHA-256 of the file you downloaded against the list below before you run it. The PowerShell one-liner does this check itself before it unpacks anything, but you should not have to take our word for it.

Latest release: v1.0.0-beta.46 · published October 17, 2026

Bodega-One-Setup-latest.exe
e291319d7f471135bb03e51213c6b4ef2b0d5b0096f7443de4ee7d8b02970272
Bodega-One-latest-portable-x64.zip
a2f3a6c57071bb46a6787c31b4c543d070bfa82e613e3289241e7059207dafb7
Bodega-One-latest-arm64.dmg
d6471c1cd5fd5b796cbc3706c389d6fd3ea65bea8c3a40921be219ff71109bb2
Bodega-One-latest-x64.dmg
6e8d3b7a107157c5c844c00d364d283c17f61f30ac0152f0a9e12aecc2b1a8a9
Bodega-One-latest-arm64.AppImage
562e6a2b58dfdf83cbc9ffe418f1838383f5ffd38d5f9ad94c74cc5789a5eca2
Bodega-One-latest-x86_64.AppImage
a0d4eab3ac52bf378b7588eac93b1c482ea66a49fc8b36509ca7255456172343
Bodega-One-latest-amd64.deb
b529cdd1f5946a6026d6e13377058b8f45f89e10f116b2fccfdbe30365b3c12c
Bodega-One-latest-arm64.deb
eaa4c4ce918b9f82eccd2e26ad6a2264b35cd123989ea00db5bd59388412ef9d

Windows (PowerShell)

Get-FileHash .\Bodega-One-Setup-latest.exe -Algorithm SHA256

macOS / Linux

shasum -a 256 Bodega-One-latest-*

Looking for something else?

Older versions, checksums, release notes, and the full asset list live on GitHub.

Browse all releases on GitHub →

Hit a wall?

Beta testers get fast help. Drop into Discord or open an issue on GitHub. We read everything.