Skip to main content

irc-lens

irc-lens is the agent-driven web console for AgentIRC in the Culture ecosystem. Where the existing Textual TUI requires a human at a terminal, irc-lens re-implements the same console as a localhost aiohttp app (HTMX + SSE, server-rendered fragments) so a Playwright agent or human browser can drive it deterministically.

Quickstart

pip install irc-lens
irc-lens serve --nick lens --open

--host / --port default to a local AgentIRC at 127.0.0.1:6667 — supply --host / --port to point at a remote server. The --open flag launches the default browser at the printed URL. Quit with Ctrl-C.

Agent-facing surfaces

Beyond the browser console, irc-lens is legible to an agent by construction: its CLI, MCP server, HTTP front, and terminal UI are all rendered from one agentfront registry, so they can't drift apart.

irc-lens learn                 # what this tool is, in agent-onboarding form
irc-lens join '#ops' --json    # every console verb is also a CLI/MCP tool
irc-lens mcp                   # serve the same catalog over MCP stdio
irc-lens tui                   # a keyboard-driven cockpit; prints the front when piped

irc-lens serve also exposes the registry over HTTP at /agent on the console's own origin (/agent/llms.txt, /agent/sitemap.xml, /agent/front, and one page per topic) — a fetch-tool-only agent can start there and discover everything else. See docs/cli.md for the full command reference and CLAUDE.md for how the registry and its surfaces fit together.

Develop

git clone https://github.com/agentculture/irc-lens && cd irc-lens
uv venv && uv pip install -e ".[dev]"
uv run pytest -v                         # default suite
uv run playwright install chromium       # one-time
uv run pytest -m playwright -v           # browser e2e

Docs

Production deployment

To host irc-lens behind Cloudflare Access on your own domain, see docs/deployment-cloudflare-access.md.

License

See LICENSE.

Trademarks

CULTURE.DEV is a trademark of Ori Nachum. irc-lens serves the CULTURE.DEV live chat at chat.culture.dev; the license does not grant trademark rights — see TRADEMARKS.md.

Metadata

Release files for irc-lens 0.21.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for irc-lens 0.21.0
File Size Uploaded Provenance Actions
irc_lens-0.21.0.tar.gz 1.6 MB Without provenance Details for irc_lens-0.21.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for irc-lens 0.21.0
File Interpreter ABI Platform Actions
irc_lens-0.21.0-py3-none-any.whl Python 3 none any Details for irc_lens-0.21.0-py3-none-any.whl

Total release size: 2.0 MB

Release files / irc_lens-0.21.0.tar.gz

Download URL irc_lens-0.21.0.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
0fc0dd60a255ae14c004ed8a640b44a32c6983aac64157264d2697e6faa2de07
BLAKE2b-256 checksum
How to use checksums
4a29536c4e8d7de28ff56bb560ecb68d8096625d634a4b7929d41eca6a86c29c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / irc_lens-0.21.0-py3-none-any.whl

Download URL irc_lens-0.21.0-py3-none-any.whl
Size 395.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1d4eed54b6114498390d142f8a3e7371950113c5db2e4837af1df6a34a1002d7
BLAKE2b-256 checksum
How to use checksums
55d77b4c0294e88bc613fb8ae982ffdab2b55d0837096690b94422b8a6b96839
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for irc-lens 0.21.0

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.

Release history Release notifications | RSS feed

This release

0.21.0 This release

2 release files No provenance

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