Webbee 🐝 — The Open-Source ICNLI Coding Agent

PyPI Python License: GPL v3 Docs

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

Install easily using pipx (recommended) or uv:

pipx install webbee
# or with uv:
uv tool install webbee

Or install in a Python virtual environment:

python3 -m venv .venv && source .venv/bin/activate
pip install webbee

Note: Python 3.11+ is required.

💡 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 /help to 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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for notVallium from gravatar.com notVallium

Credits

Author: Imperal, Inc.

License expression

GPL-3.0-or-later
View SPDX License List

Requires

Python >=3.9

Provides Extra

intel intel-embed intel-embed-faiss intel-embed-onnx

Tags

ai-agent cli coding-agent icnli imperal llm terminal webbee

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

webbee-0.4.2.tar.gz (484.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

webbee-0.4.2-py3-none-any.whl (281.7 kB view details)

Uploaded Python 3

File details

Details for the file webbee-0.4.2.tar.gz.

File metadata

  • Download URL: webbee-0.4.2.tar.gz
  • Upload date:
  • Size: 484.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for webbee-0.4.2.tar.gz
Algorithm Hash digest
SHA256 a13df17fdb55cbdf351c4698731c1badb4c8bbb864e66b9b2251263638098b6e
MD5 0d9afd4c51027dbea53bbcebab498be1
BLAKE2b-256 44661df4f06f4941ab3dee4543c5b5ee2cbeab97ed8fde7bdf02c9b0b40a5027

See more details on using hashes here.

File details

Details for the file webbee-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: webbee-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 281.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for webbee-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f74e7047bb225e95b01fcef2ce77e68ab113031ced70787b309e8fd5f57edb30
MD5 707df5324f3c4eb20086ad925c9f0033
BLAKE2b-256 868d0ac2326f2b007885d353e11b15ec8143ad51721d072b42fd4645ee014165

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.4.2 This release

2 files

0.4.1

2 files

0.4.0

2 files

0.3.53

2 files

0.3.52

2 files

0.3.51

2 files

0.3.50

2 files

0.3.49

2 files

0.3.48

2 files

0.3.47

2 files

0.3.46

2 files

0.3.45

2 files

0.3.44

2 files

0.3.43

2 files

0.3.42

2 files

0.3.41

2 files

0.3.40

2 files

0.3.38

2 files

0.3.37

2 files

0.3.36

2 files

0.3.35

2 files

0.3.34

2 files

0.3.33

2 files

0.3.32

2 files

0.3.31

2 files

0.3.30

2 files

0.3.29

2 files

0.3.28

2 files

0.3.27

2 files

0.3.26

2 files

0.3.25

2 files

0.3.24

2 files

0.3.23

2 files

0.3.22

2 files

0.3.21

2 files

0.3.20

2 files

0.3.19

2 files

0.3.18

2 files

0.3.17

2 files

0.3.16

2 files

0.3.15

2 files

0.3.14

2 files

0.3.13

2 files

0.3.12

2 files

0.3.11

2 files

0.3.10

2 files

0.3.9

2 files

0.3.8

2 files

0.3.7

2 files

0.3.6

2 files

0.3.5

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page