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.
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 | iexThe 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.
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.
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 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 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-*.AppImagePrefer a package? Grab the .deb for amd64 or arm64.
AppImage ~195 MB · .deb ~140 MB
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 | shWindows (Scoop, recommended)
scoop install https://github.com/BodegaoneAI/bodegaone-cli-releases/releases/latest/download/bodega.jsonWindows (PowerShell one-liner)
irm https://bodegaone.ai/cli.ps1 | iexHomebrew 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
- Install and launchUse the one-liner or the installer for your platform above. The app makes no outbound request until setup is done.
- 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.
- 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.
- 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.
- 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.
| Area | Requirements |
|---|---|
| Windows | Windows 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. |
| macOS | macOS 12 or later. Apple Silicon or Intel, separate builds for each. Signed and notarized. ~180 MB download. |
| Linux | Ubuntu 22.04+ or a similar modern distro. x64 or ARM64. AppImage ~195 MB, .deb ~140 MB. |
| Memory | 8 GB RAM minimum. 16 to 32 GB for comfortable agent runs with mid-size local models. |
| Disk | 10 GB free minimum, 50 GB recommended. Local models are the big part. |
| GPU | None required. CPU-only works with 1-4B models. For mid-size models, an NVIDIA card with 8+ GB VRAM. |
| Internet | Not required. Offline only works from the first launch. |
| Runtime | Electron 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 Oneor~/.config/Bodega Oneif you want it all gone. Used the one-liner? Delete%LOCALAPPDATA%\BodegaOneto 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 SHA256macOS / 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.