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 AI agents — as protocol, not framework.
| 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 |
| AV QUIC migration deep | The move to QUIC/WebTransport — SFU, MoQ, deploys |
| 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 demo | Interactive policy walkthrough |
The honest pages. Read these before you trust us with anything.
| 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 |
| S2S federation audit deep | Server-to-server correctness analysis |
| Known limitations | Explicit gaps, in public, on purpose |
| Feature catalog deep | Every implemented feature with status |
| Architecture decisions deep | Design rationale and tradeoffs |
| Future direction | Planned features and long-term vision |
All documentation lives in the GitHub repository. Site docs are in freeq-site/docs/, technical docs in docs/.
