# Bicho.FYI

> Self-hosted error tracking on Cloudflare Workers. OpenTelemetry and Sentry SDK ingestion, HTTP API, and MCP investigation.

## Documentation

- [Set up Bicho](https://bicho.fyi/docs.md): Set up Bicho on Cloudflare Workers, create your first project, and connect your app. Follow the deployment guide to capture and investigate production errors.
- [SDKs and integrations](https://bicho.fyi/docs/sdks.md): Connect your app with Bicho SDKs and the Astro integration. Compare browser and server capture, delivery limits, Sentry SDKs, and OTLP logs exporters.
- [JavaScript SDK](https://bicho.fyi/docs/javascript.md): Install the Bicho JavaScript SDK to capture browser errors and report Node.js exceptions. Configure filtering, batching, retries, and delivery to your server.
- [PHP SDK](https://bicho.fyi/docs/php.md): Install the Bicho PHP SDK with Composer to report exceptions and error messages. Configure backend credentials, synchronous delivery, filtering, and retries.
- [Python SDK](https://bicho.fyi/docs/python.md): Report Python exceptions and messages to Bicho with a dependency-free SDK. Install from Git, configure backend credentials, and handle synchronous delivery.
- [Astro integration](https://bicho.fyi/docs/astro.md): Add Bicho error reporting to Astro static and SSR sites. Configure separate browser and server projects, review capture limits, and protect credentials.
- [Rust SDK](https://bicho.fyi/docs/rust.md): Install the Bicho Rust crate to report errors from Tokio services and Tauri applications. Configure credentials, await delivery, and handle retries safely.
- [Move from Sentry](https://bicho.fyi/docs/sentry.md): Keep your Sentry SDK and send new errors to Bicho with a generated DSN. Configure browser or backend capture, check delivery, and review compatibility limits.
- [OpenTelemetry ingestion](https://bicho.fyi/docs/otlp.md): Send error logs to Bicho over OpenTelemetry OTLP/HTTP using JSON or protobuf. Configure exception fields, batching, request limits, and retries for your app.
- [HTTP API](https://bicho.fyi/docs/api.md): Use the Bicho HTTP API to manage projects, search issues, inspect captured errors, and update issue status. Includes authentication, endpoints, and examples.
- [Use MCP](https://bicho.fyi/docs/mcp.md): Connect an MCP client to Bicho for issue searches, stack traces, and error investigation. Learn the difference between public docs MCP and your private server.
- [Source maps](https://bicho.fyi/docs/sourcemaps.md): Upload source maps to Bicho and understand debug-ID linkage, storage, and stack-trace enrichment. Review ingestion limits before relying on symbolication.
- [Operations and limits](https://bicho.fyi/docs/operations.md): Run your Bicho installation on Cloudflare. Learn about storage, quotas, access controls, and background enrichment, and troubleshoot missing error reports.
- [Privacy and credentials](https://bicho.fyi/docs/privacy.md): Review collection and filtering in Bicho SDKs, the Astro integration, and Sentry clients, plus credentials, storage, source maps, and agent access.

## Website legal notices

- [License](https://bicho.fyi/license.md): Review Apache-2.0 licenses for Bicho core, SDKs, and the Astro integration, plus attribution and separate website content, font, and branding terms.
- [Privacy policy](https://bicho.fyi/privacy.md): Read how the Bicho website handles display preferences, cookieless analytics, browser search, and public documentation MCP requests. Find contact details.
- [Terms of service](https://bicho.fyi/terms.md): Read the terms for the Bicho documentation website and public MCP endpoint, including acceptable use, warranties, and your separate self-hosted installation.
- [Acknowledgements](https://bicho.fyi/acknowledgements.md): Acknowledgements for the open protocols, Sentry SDKs, and vendored schemas used by Bicho, with links to upstream licenses and package-specific notices.

## Other resources

- [Homepage](https://bicho.fyi/home.md): Project overview
- [Pricing](https://bicho.fyi/pricing.md): Free self-hosted software and separate provider costs
- [Full documentation](https://bicho.fyi/docs-full.md): All documentation in reading order
- [Full content](https://bicho.fyi/llms-full.txt): Homepage and complete documentation
- [OpenAPI specification](https://bicho.fyi/openapi.json): Core HTTP contract; set the server to your own instance
- [Documentation MCP setup](https://bicho.fyi/docs/mcp/#documentation-mcp): Public read-only setup assistance at https://bicho.fyi/mcp
- [Server source](https://github.com/bicho-fyi/bicho)
- [JavaScript SDK source](https://github.com/bicho-fyi/bicho-javascript)
- [PHP SDK source](https://github.com/bicho-fyi/bicho-php)
- [Rust SDK source](https://github.com/bicho-fyi/bicho-rust)
- [Python SDK source](https://github.com/bicho-fyi/bicho-python)
- [Astro integration source](https://github.com/bicho-fyi/bicho-astro)
- [Runnable SDK examples](https://github.com/bicho-fyi/bicho-examples)