Webbee 🐝 — The Open-Source ICNLI Coding Agent
Webbee is the free, open-source terminal coding agent of Imperal Cloud (the ICNLI AI Cloud OS). It acts directly in your local terminal and workspace: reading, writing, editing, refactoring, and verifying code with deep code intelligence, native multimodal vision, and live cross-platform system capabilities.
Webbee is powered by ICNLI (Infrastructure Contextual Natural Language Interface — icnli.org), the open protocol that maps natural-language intent to context-aware infrastructure actions.
Open-Source Guarantee (GPLv3): Webbee belongs to the community. No locked silos, no hidden telemetry, no arbitrary execution barriers. The model proposes; the kernel evaluates; you hold the key.
🚀 Key Features
- 🧠 Real Agentic AI Brain, Not a Chatbot: Reasons across your entire workspace, plans multi-step tasks, reads project architecture, executes terminal commands, and edits code safely.
- 👁️ Native Multimodal Vision (
view_image): Direct image inspection (UI mocks, diagrams, screenshots, graphs) for vision-capable models, with automatic graceful fallback to OCR and document extraction via File Reader. - 🌐 Integrated Web Search (
web_search&read_url): Perform live web research and retrieve documentation directly in your terminal sessions via Imperal's system web-search extension — zero local API keys required. - 🛡️ Ironclad Safety & Reversibility: Built-in Shadow Git time-machine snapshots every workspace modification (
checkpoint,diff,rollback). Revert any step instantly. - 🔌 Platform & Extension Arsenal: Seamless access to connected cloud extensions (Mail, Vikunja Tasks, Notes, Google Analytics, GitHub, Proxmox, Stripe, SSH Connections, and more).
- ⚡ Lightning Fast & Memory-Efficient: Instant startup with granular lazy imports, configurable RAM limits (256MB to 8GB) with LRU eviction, and fail-soft permission handling.
- 🖥️ First-Class Cross-Platform TUI: Beautiful, responsive terminal interface compatible with macOS (Terminal.app, iTerm2), Linux (Alacritty, Kitty, WezTerm), and Windows Terminal. Normalized 2-cell icon widths for pixel-perfect alignment.
📦 Installation
pipx install webbee
# or: uv tool install webbee
# or: pip install webbee (inside a virtual environment)
No Python tools at hand? One line installs uv (it brings its own Python) and webbee:
curl -LsSf https://raw.githubusercontent.com/imperalcloud/webbee-code/main/install.sh | sh
Works with any Python from 3.7:
- Python 3.10 or newer — webbee runs directly on it.
- Python 3.7 – 3.9 (macOS ships 3.9, Ubuntu 20.04 has 3.8) — the install is light, and the first
webbeecommand sets up the same release on its own Python 3.12, once (about 30–45 s, needs internet; it fetches uv to do it). Every start after that is immediate, and it is the full webbee — code index and search by meaning included. It lives in~/.local/share/webbee/runtime(%LOCALAPPDATA%\webbee\runtimeon Windows) and changes nothing else on your system.
Install problems
| You see | Why | Do |
|---|---|---|
Cannot install webbee==… because these package versions have conflicting dependencies / ResolutionImpossible |
a webbee release older than 0.5.6 on Python below 3.10 | pipx install "webbee>=0.5.6" (or pip install -U webbee) |
error: externally-managed-environment |
pip install into the system Python is blocked on Homebrew, Debian 12+, Ubuntu 23.04+ |
pipx install webbee or uv tool install webbee |
webbee: command not found after install |
the tool folder is not on PATH |
pipx ensurepath (or uv tool update-shell), then open a new terminal |
Could not set up webbee on Python 3.12 on the first start |
Python 3.7–3.9 and no internet (or a proxy blocks github.com / pypi.org) | allow those hosts and start webbee again, or use the one-line installer above |
No matching distribution found for webbee |
Python 3.6 or older | the one-line installer above — it brings its own Python |
💡 Quick Start
# Start Webbee in your project workspace
webbee
# Sign in to link your Imperal Cloud account (RFC 8628 device flow)
webbee login
Inside the interactive terminal:
- Speak naturally in English, Ukrainian, or any language you prefer.
- Type
/helpto see all available slash-commands (/login,/mode,/status,/cost,/clear,/exit). - Use Shift + TAB to cycle execution modes:
- default: Asks confirmation for major changes or destructive operations.
- plan: Formulates an exhaustive execution strategy before touching any code.
- autopilot: Autonomous mode for rapid prototyping and uninterrupted development runs.
🛠️ Built-in Terminal Toolset
| Icon | Tool | Description |
|---|---|---|
| 📖 | read_file |
Read text and source files byte-exact, with offset/limit paging |
| ✏️ | write_file |
Create or overwrite files atomically with snapshot tracking |
| 🔧 | edit_file / multi_edit |
Precise find-and-replace edits across one or multiple files |
| ⚡ | shell |
Execute shell/terminal commands across Windows, macOS and Linux with streaming |
| 🔎 | grep / glob |
Fast regex code search and workspace file pattern matching |
| 🌐 | web_search / read_url |
Search the web and read web documentation in clean Markdown |
| 🖼️ | view_image |
Inspect images with native multimodal vision + OCR fallback |
| 🗂️ | diff / rollback |
Inspect recent changes and roll back to previous checkpoints |
📜 License
Webbee is free and open-source software licensed under the GNU General Public License v3.0 (GPL-3.0-or-later). See the LICENSE file for details.
Developed with 🐝 by the Imperal Cloud team.
1 maintainer
Metadata
1 maintainer
Release files for webbee 0.5.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| webbee-0.5.6.tar.gz | 514.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| webbee-0.5.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 812.2 kB
Release files / webbee-0.5.6.tar.gz
| Download URL | webbee-0.5.6.tar.gz |
|---|---|
| Size | 514.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
91ca43f87d44a513f58fdd702665d754e26ac2dd98af3a46f61ba43f555c52cf
|
|
BLAKE2b-256 checksum How to use checksums |
c7784d87dc52e2e9dc09f989006541cd1803b6bbf56d02f8dd92c6ed879ebacc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Release files / webbee-0.5.6-py3-none-any.whl
| Download URL | webbee-0.5.6-py3-none-any.whl |
|---|---|
| Size | 297.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
22b5be29119e5f0aa27baee80693bba076c917dc67e75154cc5adc10fcb92c15
|
|
BLAKE2b-256 checksum How to use checksums |
2b908e75d4074151457773e95635b06f8d7f39f7543e8fc969cb4c8b0a71daac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for webbee 0.5.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
