elizaOS Documentation

The tunnel-proxy is a Railway-hosted service that provides public URLs for Eliza Cloud tunnels. It acts as a bridge between public TLS-terminated hostnames and internal Headscale MagicDNS hosts.

Mapping Logic: Public hostnames like eliza-<org>-<random>.tunnel.elizacloud.ai are mapped to internal hosts like https://eliza-<org>-<random>.tunnel.eliza.local.

Security & Routing:

• When TUNNEL_HOSTNAME_SIGNING_SECRET is configured, the proxy only routes hostnames matching the pattern: eliza-<orgpart>-<randomhex>-<expiry>-<signature>.
• Arbitrary wildcard labels or root traffic return a 404 error.
• The /health and /ready endpoints remain public to allow Railway and DNS smoke checks to function.

doctr.cpp is a C++ port of Mindee doCTR built on ggml. It provides a high-performance implementation of two stages for document processing:

1. Detection: Uses a db_mobilenet_v3_large backbone with a DBNet head to produce a probability map.
2. Recognition: Uses a crnn_mobilenet_v3_small backbone with a BiLSTM and CTC head to produce per-crop logits.

Note on Workflow: The C++ library only handles the forward pass. The TypeScript caller orchestrates the full pipeline: detection $\rightarrow$ crop $\rightarrow$ recognition $\rightarrow$ decode. Post-processing (DBNet contour to bbox and CTC greedy decode) is handled in TypeScript for runtime portability.

The meeting-corpus-importers package provides license-gated importer contracts for the ElizaOS Context Benchmark. It is a code-only package designed to handle the discovery and parsing of meeting corpora without downloading or bundling actual data.

Key capabilities include:

• Corpus Registry: A P0 registry containing license and citation metadata.
• Manifest Generation: Deterministic generation of local-cache manifests.
• Fixture Parsing: A parser that emits structured data including transcript, speaker-turn, source-stream, RTTM, and annotation-coverage.
• Status Reporting: Honest reporting of missing or unavailable licensed corpora.

This package supports the same manifest shapes used by real imports such as AMI, CHiME/DiPCo, LibriCSS, VoxConverse, DIHARD, MUSAN, WHAMR, and LibriMix, but uses small synthetic fixture annotations for testing purposes.

@elizaos/plugin-feed connects an Eliza agent to the Feed prediction market game. It provides a GUI operator view and an HTTP proxy layer that allows the agent to interact with Feed markets, posts, chats, and team states.

Key features include:

• Embedded Dashboard: Integrates the Feed operator dashboard as a GUI view.
• Automatic Authentication: Automatically handles Feed authentication by preferring the existing Steward/Eliza Cloud session JWT (STEWARD_AGENT_TOKEN). If unavailable, it falls back to FEED_AGENT_ID and FEED_AGENT_SECRET with automatic token refresh.
• API Proxying: Proxies requests between the elizaOS API surface and the Feed backend for markets, social, messaging, and admin controls.

BinaryAlert is an open-source serverless AWS pipeline designed for real-time and retroactive malware detection. It monitors S3 bucket uploads via S3 event notifications and triggers AWS Lambda analysis.

Key capabilities include:

• Real-time Detection: Automatically triggers analysis upon file upload to S3.
• YARA Rule Matching: Uses configurable YARA rules for string, regular expression, and conditional matching to detect various malware types.
• Specialized Handling: Supports unpacking UPX-compressed files, deep analysis of archived content, and integration with CarbonBlack.
• Alerting: Provides real-time notifications based on matching results.

@elizaos/plugin-blocker provides focus and distraction control for Eliza agents. It enables website blocking via a SelfControl-style hosts engine and supports macOS/mobile app blocking.

Key components include:

• Providers: websiteBlocker and appBlocker (both gate to contexts: ["focus", "automation"]).
• Services: WebsiteBlockerService and AppBlockerService.
• Persistence: Uses a Drizzle pgSchema('app_blocker') for storing rules, active sessions, and allow lists.
• UI: A focus overlay view accessible at /focus via the FocusView component.

Note on Actions: This plugin does not register the BLOCK action. The BLOCK umbrella action is managed by @elizaos/plugin-personal-assistant to handle owner gating, scheduling, and chat dispatch.

Tails is a portable, privacy-focused operating system based on Debian GNU/Linux. It is designed to protect user privacy and avoid censorship by routing all internet traffic through the Tor network.

Key features include:

• No Trace: When the computer is shut down, Tails leaves no trace on the host machine.
• Portable: Runs from a USB stick instead of the installed OS (Windows, macOS, or Linux).
• Secure Defaults: Includes pre-configured applications for sensitive document work and secure communication.
• Open Source: Free to download and verifiable by independent security researchers.

HyperliquidBench is a reproducible benchmark suite designed to measure the operational competence of Hyperliquid perpetual trading agents. Unlike simple PnL tracking, it verifies an agent's ability to correctly route orders, cancels, transfers, and leverage changes.

Key features include:

• Verification-driven scoring: Uses a Base + Bonus - Penalty formula to reward breadth, discipline, and action composition while penalizing spam.
• Dual tracks:
  • Coverage track: Judges the overall operational surface area.
  • HiaN (Haystack-in-a-Needle) track: Verifies long-context precision by requiring agents to execute exact instructions from noisy prompts.
• Auditability: Every action is logged with submission payloads, HTTP acknowledgements, and websocket confirmations.