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
⚡ bash Execute shell commands in the workspace root with real-time 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:
Newer release available (0.4.2)

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.11

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.0.tar.gz (470.5 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.0-py3-none-any.whl (271.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: webbee-0.4.0.tar.gz
  • Upload date:
  • Size: 470.5 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.0.tar.gz
Algorithm Hash digest
SHA256 266b1f0d37ba7a370032d387e9f379c456d94b587c05d721d7684366d5ae4e1d
MD5 3180bb2ff71ce84d5b7ed6e11248fa58
BLAKE2b-256 27c9c6f45c625d5539ab83ffdf891372b0ddc9d481c518861596a76ad72a6e65

See more details on using hashes here.

File details

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

File metadata

  • Download URL: webbee-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 271.8 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 944933c43347a41b919ab29f9e172362f56b826431c93c003b99310b134da558
MD5 90a44498fd5908a790201a1262bea77c
BLAKE2b-256 a9d25262e941600b27f2bbf1d5510d68884b440e8bccaeb2ee51965cff68cb02

See more details on using hashes here.

Release history Release notifications | RSS feed

0.4.2

2 files

0.4.1

2 files

This release

0.4.0 This release

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