Supported by
Powered by
Guides, references, and deep dives. Pick your track.
| What is freeq? | What this is, how it differs from IRC and Slack/Discord, and why it matters |
| Getting started | Connect as a user, run your own server, build your first bot |
| Connection guide | Every supported transport and client |
| Different from IRC how? | DID identity, persistent ops, modern features — for IRC veterans |
Identity, observable work, governance, and voice for software agents — specified at the protocol level.
| Agent quickstart new | A did:key agent saying hello in #playground, in about 60 seconds |
| Watch your coding agent new | Wire Claude Code / pi into a channel you can read from irssi on your phone |
| Building agents | The five primitives — identity, events, governance, provenance, liveness — plus a full worked tutorial |
| Bot quickstart | Your first bot in 10 minutes, TypeScript or Rust |
| TypeScript SDK | @freeq/sdk + @freeq/bot-kit reference |
| Voice & video agents | Join live calls: media loop, voice-activity segmentation, talking back |
| Bot framework | Commands, permissions, webhooks, LLM personas |
| Agent assistance | Structured diagnostics at /agent/tools/* — let your bot ask the server why |
| Agent discovery | A2A-style discovery at /.well-known/agent.json |
| Clients overview | All six first-party clients + guest access from any IRC client |
| Web client | Reactions, threads, media, search, calls — in a tab |
| iOS app | Native SwiftUI via Rust FFI |
| Authentication | AT Protocol SASL, OAuth, web tokens, DID identity |
Everything is an IRCv3 extension. These are the specs.
| Protocol overview | The whole surface on one page |
| Tag registry new | Every +freeq.at/* message tag with semantics |
| Protocol notes deep | SASL ATPROTO-CHALLENGE, DID extensions, transport stack, plugin hooks |
| AV call protocol | TAGMSG signaling + MoQ media transport |
| Federation | S2S over iroh QUIC with CRDT convergence |
| Policy framework | Channel governance as verifiable credentials + transparency logs |
| Credential verifiers | GitHub verifier, custom verifiers, decoupled architecture |
| REST API | Health, channels, history, users, upload, policy, credentials |
| Self-hosting quickstart new | Miren, Docker, or single binary — running in 5 minutes |
| Self-hosting guide | TLS, nginx, systemd, credential verifiers |
| Self-hosting end to end | Single host from scratch: build, secrets, DID, proxy, backups |
| freeq for teams new | Private company chat: self-host + SSO-gated E2EE channels |
| Moderation | Halfops, moderator credentials, third-party moderation services |
| Policy system guide | Channel policies, credential types, web UI, DID ops |
| Policy walkthrough | Step-by-step: credential-gated channels and the audit trail behind them |
| Security hardening | Operational guidance for running freeq in production |
What is protected, what is not, and how to verify it yourself.
| Encryption & security | Every data path mapped — what's encrypted, what's not, and the roadmap |
| Company E2EE channels | Private, SSO-gated, end-to-end encrypted channels — offboarding revokes access |
| VC-bootstrapped E2EE deep | EG1/EGK1 wire formats, sealed group keys, epoch rotation |
| Known limitations | Current gaps and unsupported cases, stated explicitly |
| Feature catalog deep | Every implemented feature with status |
| Architecture decisions deep | Design rationale and tradeoffs |
All documentation is maintained in the GitHub repository alongside the code. Corrections and additions are welcome as pull requests.
