Webbee 🐝 — The Open-Source ICNLI Coding Agent
Python 3.7 – 3.14 · pip install webbee works on every one of them.
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/runtimeand 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.8
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.8.tar.gz | 515.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| webbee-0.5.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 812.7 kB
Release files / webbee-0.5.8.tar.gz
| Download URL | webbee-0.5.8.tar.gz |
|---|---|
| Size | 515.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c605c50e6a5a4a0f51f9221a5650bfb3d8829ac2dffa58f92d9fed8fea544a6c
|
|
BLAKE2b-256 checksum How to use checksums |
04f48a0ba17ccc63bca2de5edf9a5599c2c8e0492588b2fcea052b304d3adc48
|
| 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.8-py3-none-any.whl
| Download URL | webbee-0.5.8-py3-none-any.whl |
|---|---|
| Size | 297.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a3432060a4c43faad1a26f8d0ec804ad9dc9e38121a4c3549c20865d7433baed
|
|
BLAKE2b-256 checksum How to use checksums |
5aa4bd15dff206e547816e506e74df3a6b88e15ab547083c3ffecff575b552ca
|
| 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.8
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.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
