hub / github.com/Ramtx/Bouno

github.com/Ramtx/Bouno @v1.3.2

repository ↗ · DeepWiki ↗ · release v1.3.2 ↗ · + Follow

917 symbols 1,942 edges 167 files 31 documented · 3%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Bouno

Open-source browser automation Chrome extension. Control web pages using natural language through multiple LLM providers — bring your own API key or sign in with OAuth.

Download Latest Release

Demo

https://github.com/Mariozada/Bouno/blob/main/docs/demo.mp4

Features

Natural Language Control — tell it what to do in plain English, it clicks, types, scrolls, and navigates for you
Multi-Provider Support — Anthropic, OpenAI, Google, Groq, OpenRouter, and OpenAI-compatible endpoints (Ollama, LM Studio). OAuth sign-in available for OpenAI and Google
Side Panel UI — stays open alongside any webpage
Tab Group Isolation — each session is scoped to its own tab group
Conversation Branching — edit messages and explore different response paths
Scheduled Tasks — set up recurring automations
Screenshots & GIFs — capture what's happening on screen
Chat Persistence — conversations saved locally in IndexedDB
MCP Support — connect external tools via the Model Context Protocol
Custom Skills — create reusable automations you can invoke by name
Privacy First — no backend, no data collection, API calls go directly to your provider

Install

From Release (recommended)

Download bouno.zip
Unzip the file
Open chrome://extensions
Enable Developer mode
Click Load unpacked and select the unzipped folder

Dev Build (latest from main)

Download bouno-dev.zip
Unzip the file
Open chrome://extensions
Enable Developer mode
Click Load unpacked and select the unzipped folder

Build from Source

bun install
bun run build

Then load the dist/ folder as an unpacked extension.

Configuration

Open the extension side panel and go to Settings.

API Keys

Anthropic — console.anthropic.com
OpenAI — platform.openai.com (or sign in with OAuth)
Google — aistudio.google.com (or sign in with OAuth)
Groq — console.groq.com
OpenRouter — openrouter.ai

Local Models

Select "OpenAI Compatible" provider: - Ollama — http://localhost:11434/v1 - LM Studio — http://localhost:1234/v1

Browser Compatibility

This extension has been tested on Google Chrome only. It may work on other Chromium-based browsers (Edge, Brave, Arc, etc.), but you might encounter issues. If you do, please open an issue.

Contributing

Contributions are welcome! Feel free to open a PR.

License

MIT

Extension points exported contracts — how you extend this code

ToolParameter (Interface)

(no doc)

src/tools/definitions/types.ts

MarketplaceSkill (Interface)

(no doc)

src/marketplace/manager.ts

WalletState (Interface)

(no doc)

src/wallet/solana.ts

CodexAuth (Interface)

(no doc)

src/auth/types.ts

MessageInput (Interface)

(no doc)

src/storage/messageStorage.ts

RelayRequest (Interface)

(no doc)

src/background/relayClient.ts

JsonRpcRequest (Interface)

(no doc)

src/mcp/client.ts

OpenAICompatibleConfig (Interface)

(no doc)

src/shared/settings.ts

Core symbols most depended-on inside this repo

push

called by 95

src/agent/workflow/tools.ts

str

called by 39

src/ui/components/ToolCallDisplay/helpers.tsx

log

called by 36

src/agent/providers.ts

loadSettings

called by 24

src/shared/settings.ts

log

called by 23

src/tools/handlers/pageReading.ts

registerTool

called by 19

src/tools/registry.ts

mergeClassNames

called by 19

src/ui/components/MarkdownMessage.tsx

obj

called by 16

src/ui/components/ToolCallDisplay/helpers.tsx

Shape

Function 641

Interface 209

Method 47

Class 20

Languages

TypeScript100%

Modules by API surface

src/skills/storage.ts21 symbols

src/ui/hooks/useWorkflowStream.ts20 symbols

src/ui/components/ToolCallDisplay/renderers.tsx20 symbols

src/agent/streamParser.ts20 symbols

src/tools/handlers/media.ts19 symbols

src/content/accessibilityTree.ts19 symbols

src/auth/gemini.ts18 symbols

src/agent/tracing/tracer.ts18 symbols

src/shared/types.ts17 symbols

src/agent/workflow/types.ts17 symbols

src/agent/workflow/tools.ts17 symbols

src/wallet/solana.ts16 symbols

For agents

$ claude mcp add Bouno \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

github.com/Ramtx/Bouno @v1.3.2

Bouno

Demo

Features

Install

From Release (recommended)

Dev Build (latest from main)

Build from Source

Configuration

API Keys

Local Models

Browser Compatibility

Contributing

License

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Languages

Modules by API surface

For agents

Ask about this repo answers extend the page