Skip to content

Kiwibro: a local AI agent for Linux that runs on LM Studio

Open-source software · 2 min read · updated

Kiwibro is a local-first AI agent for Linux. A small Python Flask server on your machine talks to LM Studio through its local OpenAI-compatible API, and a browser GUI styled like a GNOME app sits on top. Pick any model you have, chat with it, and let it search the web, read pages, edit files or run commands inside its own workspace, with your permission. Chats, memories and settings stay in SQLite on disk; there are no accounts and no telemetry. It is MIT-licensed.

Platform
Linux (developed on Ubuntu)
Language
Python
Licence
MIT
Requires
  • Python 3.10+; run.sh installs Flask, requests and beautifulsoup4 into a local .venv
  • LM Studio with its local server on and a chat model
  • Chrome or Chromium for the app window, or any modern browser
Run
./scripts/run.sh from the repository folder
Kiwibro start screen: the green kiwi mark above "A local AI that keeps its beak out of the cloud", three suggestion chips and the Ask Kiwibro composer with its Agent toggle.
The start screen, from the screenshots in the repository.

How do I run Kiwibro?

git clone https://github.com/yunusemrejr/kiwibro.git
cd kiwibro
./scripts/run.sh        # installs Flask, requests and beautifulsoup4 into a local .venv if needed

Then open http://127.0.0.1:8777. In LM Studio, start the local server (Developer → Start Server, default http://127.0.0.1:1234). Kiwibro lists every chat model you have; LM Studio loads one just in time if it is not loaded yet. ./scripts/install.sh adds an app icon and a .desktop launcher that starts the server and opens a Chrome app window, without root.

What can the agent do?

ToolDefault
web_search, fetch_pageRuns automatically
read_file, list_files, rememberRuns automatically
write_file, replace_in_fileAsks first, with a preview of the file
run_commandAsks first, with the exact command

Each approval card offers Allow once, Always for that tool, or Deny, and every mode can be changed in Settings. Files live in ~/Kiwibro by default. Commands run as your user, inside the workspace, with a timeout and a blocklist; the README calls that a strong guardrail, not a container.

How do memory and context work?

After each reply Kiwibro extracts durable facts, deduplicates and categorises them, and adds only the relevant ones to the prompt. Memory is global: it is shared across chats and survives model swaps and restarts, and you can pin, edit or delete each fact. When a conversation nears the model's context window, the older part is folded into a rolling summary and recent turns stay verbatim, so long chats keep going without a "context length exceeded" error. The transcript itself is never rewritten.

How is it kept local?

  • The Flask server binds to 127.0.0.1 and rejects non-local Host headers.
  • Chats, memories and settings are in ~/.local/share/kiwibro/kiwibro.db.
  • No analytics, accounts, CDNs or web fonts. The network is used only by the web tools.
  • File tools are confined to the workspace; page fetching refuses localhost, private and link-local addresses.

The repository's tests cover this contract: 67 unit, API and security tests and 54 end-to-end checks against a fake LM Studio, run in CI on every push.

Quick answers

Does Kiwibro need an internet connection?
No. It talks to LM Studio on localhost and stores everything in a local SQLite database. Only the web search and page-reading tools use the network.
Which models does Kiwibro work with?
Any chat model you have in LM Studio. Kiwibro reads the live model list, and you can switch models from the header mid-chat without changing transcripts or memory.
Is Kiwibro an Electron app?
No. It is a browser GUI on purpose: a Flask server on loopback plus a Chrome app window opened by its desktop launcher. Any modern browser also works.
Can the agent run commands without asking?
Not by default. File writes and shell commands pause for approval. You can choose Always for a tool, and every permission mode can be changed in Settings.

More on Downloads