Skip to content

wacht-platform/platform

Repository files navigation

The open-source identity, access, and agent runtime backend for modern SaaS.

License Status Built with Rust

Website · Docs · Issues · Changelog


Overview

Wacht Platform is the backend that powers Wacht — a programmable identity, access, and agent platform for B2B and SaaS products. It exposes the control plane, authentication runtime, integration surface, and the agent execution engine that applications build on top of.

It is designed for teams that treat identity, authorization, and AI workflows as first-class product surfaces rather than commodity infrastructure.

Capabilities

  • Multi-tenant authentication. Sign-in, sign-up, MFA, sessions, and deployment-scoped policies.
  • B2B access model. Organizations, workspaces, roles, and a permission catalog suitable for customer-facing admin UIs.
  • Machine and user authorization. Token issuance, API keys, scoped credentials, and authorization decisions for both human and service callers.
  • OAuth and integrations. First-party OAuth provider plus relay flows for external services.
  • Event-driven operations. Webhooks, async workers, retries, notifications, usage metering, and billing hooks.
  • Agent runtime. A first-class engine for long-running, tool-using agents with sandboxed execution, scheduled work, and human-in-the-loop approvals.

Architecture

The system is organized into four planes:

Plane Responsibility
Control plane Configure deployments, policies, auth factors, and access models.
Runtime plane Execute sign-in/sign-up flows and authorization decisions at request time.
Integration OAuth providers, webhooks, and external service connectors.
Operations Background workers, retries, notifications, usage and billing pipelines.

This repository is the backend for those four planes. It is consumed by:

  • console — operator UI for managing platform configuration.
  • frontend-api — end-user authentication flows embedded in application frontends.

Repository Layout

platform/        HTTP entrypoints (console-api, frontend-api, oauth-relay)
agent-engine/    Agent execution runtime, planner, tool dispatch
worker/          Background job runner (webhooks, retries, schedules)
commands/        Write-side handlers (CQRS-style commands)
queries/         Read-side projections and query handlers
models/          Domain models and persistence types
dto/             Wire types shared across services
templatekit/     Prompt and template assets for the agent engine
common/          Shared utilities (telemetry, error, config)
oauth-relay/     OAuth relay service
scripts/         Operational and developer scripts

Quickstart

Requirements: a recent stable Rust toolchain, PostgreSQL, and NATS.

# Verify the workspace builds
cargo check --workspace

# Run the console API
CONSOLE_API_PORT=3001 cargo run -p platform --bin console-api

# Run the background worker
cargo run -p platform-worker --bin worker

See the documentation for environment variables, schema migrations, and deployment guidance.

Status

Wacht Platform is in public beta. The HTTP surface and data model are stabilizing; breaking changes are documented in the changelog. Production usage is supported with the expectations typical of a beta release.

Contributing

We're not accepting pull requests yet — the contribution process isn't set up. Forks, self-hosting, and any other use the AGPL-3.0 allows are welcome. Self-hosting documentation is still in progress.

Support

License

Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only). See LICENSE.md for the full text.


* This README was AI-generated.

About

Ship product, not plumbing. Open source framework for AI-first SaaS — identity, OAuth, API auth, webhooks, notifications, and agents in one stack.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages