v0.1.1 · MIT · Local-first · BYOK

Your local AI studio, in a single binary.

Chat and image generation with Gemini, OpenAI, Anthropic, and DeepSeek — with your own keys. The app, database, and API keys stay on your machine; prompts and content go only to the provider you select. No telemetry, no Node.

install
  • powershell · Windows$ irm https://mangostudio.dev/install.ps1 | iex
  • shell · Linux, macOS$ curl -fsSL https://mangostudio.dev/install.sh | bash
  • bun · Windows, Linux, macOS$ bun add -g mangostudio
  • npm · Windows, Linux, macOS$ npm i -g mangostudio
  • scoop · Windows$ scoop bucket add juliopolycarpo https://github.com/juliopolycarpo/scoop-bucket && scoop install mangostudio
  • brew · Linux, macOS$ brew install juliopolycarpo/tap/mangostudio
  • cargo · Windows, Linux, macOS$ cargo install mangostudio
  • docker · Docker$ docker run -p 3001:3001 -v mango-data:/data ghcr.io/juliopolycarpo/mangostudio
$ curl -fsSL https://mangostudio.dev/install.sh | bashPlanned channel — not available yet

requires Bun v1.3.14+ · macOS · Linux · Windows

~/projects — zsh
➜ $ mangostudio serve
▸ MangoStudio v0.1.1 (bun 1.3.14)
▸ database ~/.mango/database.sqlite
▸ providers gemini · openai · anthropic ✓
▸ ready ── http://localhost:3001
localhost:3001
MangoStudioonline
Generate a minimalist mango icon
Sure — generating 1 image 1024×1024…

One command boots the API (Elysia + SQLite) and the React UI — and opens the studio in your browser.

Quickstart

From zero to studio in 3 steps

1

Install

Pick the platform and installer that fit your machine. Every ready channel installs the same binary.

bun add -g mangostudio
2

Configure

Add your provider key in config.toml or via an environment variable.

export GEMINI_API_KEY=…
3

Serve

Boot the API + UI and open the studio in your browser. Ready to chat.

mangostudio serve
Features

A complete studio, local-first

Multi-model chat

SSE streaming, extended reasoning, tools, and mid-conversation model switching.

Image generation

Generate images straight from chat with compatible models and a persisted local gallery.

Attachments

Upload files and images; MangoStudio hands them to the provider at the right turn.

Tools & agents

grep, glob, shell, read_file, and subagent delegation with its own lifecycle.

Keys & BYOK

Keep keys in the OS secret store, in config.toml, or in .env. You stay in control.

Local-first & SQLite

Chats and settings persist in local SQLite via Kysely. The app, database, and API keys stay on your machine; prompts and content go only to the provider you select.

Bring your own keys

Works with the providers you already use

GGemini
◯OpenAI
AAnthropic
DDeepSeek
{}OpenAI-compatible
★ Open source · MIT

Built in the open, with the community

Modular DDD architecture, end-to-end typed contracts, and docs to contribute. Issues and PRs are welcome.