microclimate

A LiveKit-based alternative to Mumble and Discord.

Requires

• Rust
• Deno
• protoc, the protobuffer compiler
• A server/.env file, see server/.env.example for required values

Project structure

The server and Tauri client are separate Cargo workspaces. Most server-side Cargo commands should be run from the server/ directory; most client-side commands are run from the project root (via Deno tasks) or src-tauri/.

Setup

Server

The server uses SQLx compile-time query verification, which requires either a live database or a pre-generated query cache. The cache is already committed to the repository under server/.sqlx/, so a live database is only needed when you change the schema.

# Copy and fill in the environment file
cp server/.env.example server/.env

# JWT_SECRET is required — the server uses it to sign session tokens issued
# after a successful ATProto OAuth login. Use a long random value, e.g.:
#   openssl rand -base64 32

# (First time only, or after changing migrations) Install sqlx-cli and
# run migrations to set up the database
cargo install sqlx-cli --no-default-features --features sqlite
cd server && sqlx migrate run

# (After changing migrations) Regenerate the SQLx query cache and commit it
cd server && cargo sqlx prepare

Note: In production, migrations run automatically when the server starts.

Client

Install dependencies with deno i

If on windows create a windows.toml file in the .cargo folder then add the following:

[build]
target-dir = "C:/t"

Without it vite will choke itself scanning the target folder, and the application will never run.

Git hooks

The repo ships a pre-commit hook in .githooks/ that runs deno fmt --check, deno lint, and cargo fmt --check for both crates — the fast checks CI also runs. To enable for your clone:

git config core.hooksPath .githooks

Use git commit --no-verify to skip on a one-off basis.

Running

# Start the gRPC server (from server/)
cd server && cargo run

# Start the Tauri desktop app (from project root, use cmd.exe on Windows)
deno task tauri dev

Note: cargo build from the project root only builds the Tauri client. To build the server, run cargo build from server/.

Self-hosted voice relay

Voice transport runs over iroh, which uses a relay server as rendezvous point and NAT-traversal fallback. By default that's iroh's public infrastructure (currently canary-tier while iroh 1.0 is in release candidates). For a production deployment, host your own — the relay is embedded in the server binary and enabled with env vars (see server/.env.example):

• IROH_RELAY_BIND=[::]:3340 starts the embedded relay (plain-HTTP websocket service) and is the only required setting: the advertised URL defaults to http://<PUBLIC_HTTP_URL host>:3340, so exposing the port on the same host as the gRPC server just works. With the relay active, voice has no third-party dependencies: clients skip iroh's DNS discovery entirely and dial the addresses the server hands out over gRPC.
• IROH_RELAY_URL=https://relay.example.com overrides the advertised URL — set it when the relay sits behind a TLS reverse proxy.
• MOQ_IROH_BIND_V4=0.0.0.0:7800 (optional) pins the voice endpoint to a stable UDP port. Forward it on your router and set MOQ_IROH_PUBLIC_ADDRS=<wan-ip>:7800 so clients connect directly; without it, traffic falls back to the relay (which always works, just adds a hop).

If a session still drops, the client now notices: it shows "reconnecting…" in the sidebar and rejoins automatically with backoff.

For the full configuration reference (required values, ports, reverse-proxy setup), see docs/deployment.md.

Tips

• If you're developing on Windows, I've observed that the Tauri app will not render when executing deno task tauri dev from Powershell. Using cmd seems to work just fine, though.
• On Windows, set CARGO_TARGET_DIR=C:/t (or another short path) to redirect Cargo build artifacts off the project tree.
• I recommend using Yaak for testing gRPC features without a client
• Use cargo test export_bindings from src-tauri/ to generate TypeScript types from structs using ts-rs