Management console
These variables are required in the Console environment configuration file for production deployments.| Variable | Mode | Purpose |
|---|---|---|
WORKOS_API_KEY | Production | Enables remote WorkOS management. |
WORKOS_CLIENT_ID | Production | Required for AuthKit login. |
WORKOS_COOKIE_PASSWORD | Production | Password for encrypting secure session cookies. |
WORKOS_REDIRECT_URI | Production | The AuthKit redirect URI (e.g., http://localhost:3000/callback). |
DENO_DEPLOY_TOKEN | Production | Enables remote Deno Deploy orchestration. |
TURSO_API_TOKEN | Production | Enables remote Turso database provisioning. |
TURSO_ORG | Production | Defines the Turso organization slug. |
WORLDS_EMBEDDINGS_DIMENSIONS | Both | Sets unified vector dimensions for DB and AI. Defaults to 768. |
OPENROUTER_API_KEY | Both | Provides a global fallback for embeddings. |
OPENROUTER_MANAGEMENT_KEY | Production | Enables automatic per-app API key generation via OpenRouter API. |
OLLAMA_BASE_URL | Both | Sets Ollama API URL. Defaults to http://127.0.0.1:11434. |
OLLAMA_EMBEDDINGS_MODEL | Both | Sets Ollama model. Defaults to nomic-embed-text. |
World server
The console automatically provisions and injects these variables during deployment. You only need to set them manually if you are self-hosting the server.| Variable | Purpose |
|---|---|
WORLDS_API_KEY | Sets the root admin key for the server. If omitted, the server runs in unprotected mode. |
WORLDS_EMBEDDINGS_DIMENSIONS | Sets unified vector dimensions for DB and AI. Defaults to 768. |
WORLDS_BASE_DIR | Defines the base directory for local world storage. Defaults to ./worlds. |
LIBSQL_URL | Defines the connection string. Defaults to file:./worlds.db. |
LIBSQL_AUTH_TOKEN | Provides the auth token for remote libSQL/Turso instances. |
TURSO_API_TOKEN | Enables remote Turso database provisioning for managed worlds. |
TURSO_ORG | Required if TURSO_API_TOKEN is set. |
OPENROUTER_API_KEY | Enables high-quality OpenRouter embeddings. |
OPENROUTER_EMBEDDINGS_MODEL | Sets OpenRouter model. Defaults to openai/text-embedding-3-small. |
OLLAMA_BASE_URL | Sets Ollama API URL. Defaults to http://127.0.0.1:11434. |
OLLAMA_EMBEDDINGS_MODEL | Sets Ollama model. Defaults to nomic-embed-text. |
CLI
The Worlds CLI utilizes environment variables for both remote and local operations.| Variable | Mode | Purpose |
|---|---|---|
WORLDS_API_KEY | Remote | Your API key for connecting to a remote server. |
WORLDS_BASE_URL | Remote | API base URL for remote mode (e.g., https://api.wazoo.dev). |
LIBSQL_URL | Local | Database connection URL for local in-process server mode. |
OPENROUTER_API_KEY | Chat | Enables AI chat functionality via OpenRouter. |
OPENROUTER_MODEL | Chat | Sets the model for AI chat. Defaults to google/gemini-2.0-flash-001. |
Embedding providers
The platform selects an embedding provider based on available environment variables:- OpenRouter: Triggered when
OPENROUTER_API_KEYis present. Recommended for cloud-based AI. - Ollama: Default provider when no cloud keys are present. Recommended for local development and private hosting.