Skip to content
@bicho-fyi

Bicho.FYI

Open-source error tracking for Cloudflare. Capture with OpenTelemetry, investigate with MCP.

Bicho.FYI

Self-hosted error tracking for AI agents. Deploy Bicho to your own Cloudflare account, capture production errors, and investigate through MCP or the HTTP API. D1 and a private R2 bucket keep the evidence in your account. There is no built-in dashboard.

Bicho means "bug" in Spanish. Bicho.FYI: the bug, for your information.

Website · Documentation · Server source

SDKs and integrations

SDK or integration Package Capture and delivery
JavaScript / TypeScript @bicho-fyi/javascript Automatic browser capture and explicit Node.js reporting. Queued delivery with flush/close.
PHP bicho-fyi/php Explicit exception and message capture. Synchronous delivery.
Rust bicho Explicit error and message capture. Awaited delivery on Tokio, including Tauri applications.
Python bicho-fyi Explicit exception and message capture. Synchronous delivery. Python 3.11+, no runtime dependencies.
Astro @bicho-fyi/astro Opt-in browser error capture and server request-exception reporting. Separate browser/server configuration and bounded server delivery.

All Bicho SDKs send OTLP/HTTP JSON. Other languages and existing instrumentation can use an OpenTelemetry logs exporter with HTTP JSON or binary protobuf. You do not need a separate OpenTelemetry Collector.

SDK guides · Runnable SDK examples

Already using Sentry?

Keep your SDK and error-capture code. Create a Bicho project and replace your DSN with its generated sentry.dsn. Secret-enabled backend projects also need the generated transport headers.

Bicho accepts error and message events, not tracing, replay, or profiling. Disable unsupported integrations. Switching the DSN redirects new errors; it does not import Sentry history or reproduce Sentry's grouping rules.

Move from Sentry

Deploy and investigate

Deploy Bicho to Cloudflare, connect your MCP client, and call create_project. It returns the project ID, OTLP endpoint and ingest headers, and a Sentry DSN.

Bicho groups repeated errors into issues and preserves their individual events. Your agent can search issues, inspect stacks and context, compare releases, and read statistics. It can also create projects and update issue status. Approve those changes deliberately; captured error text is evidence, not instructions.

Setup guide · MCP guide · HTTP API

Contribute

Questions, ideas, or something you've built with Bicho? Join the community discussions.

Bug reports and focused contributions are welcome in the relevant server or SDK repository. Use that repository's Issues for bugs.

Bicho core and SDKs are licensed under Apache-2.0. Made by Alex Zappa (FreshJuice). Bicho is not affiliated with, sponsored by, or endorsed by Cloudflare or Sentry.

Pinned Loading

  1. bicho bicho Public

    Self-hosted error tracking on Cloudflare Workers, with OTLP ingestion and MCP tools for investigating errors.

    JavaScript

  2. bicho-examples bicho-examples Public

    Runnable Bicho SDK examples for browsers, Node.js, PHP, Rust and Python, plus Sentry error reporting.

    JavaScript

  3. bicho-javascript bicho-javascript Public

    JavaScript SDK for browser error tracking with Bicho, using OpenTelemetry (OTLP).

    JavaScript

  4. bicho-php bicho-php Public

    PHP SDK for reporting exceptions and errors to Bicho over OTLP/HTTP JSON

    PHP

  5. bicho-rust bicho-rust Public

    Rust SDK for reporting errors to Bicho over OTLP/HTTP JSON, with async delivery and Tauri integration.

    Rust

  6. bicho-python bicho-python Public

    Native Python SDK for Bicho error tracking over OTLP/HTTP JSON. Python 3.11+, no runtime dependencies.

    Python

Repositories

Showing 8 of 8 repositories

Top languages

Loading…

Most used topics

Loading…