Environment Variables

Autonome uses T3Env with Zod validation to provide type-safe environment variable access. All configuration is defined in src/env.ts and validated at startup.

Never commit real API keys or secrets to version control. Use .env.local for local development and secure environment variable management in production.

Setup

Copy the example environment file and fill in your values:

cp .env.example .env

Edit .env with your configuration. The application will automatically load .env and .env.local files on startup.

Using Environment Variables

Never access process.env directly. Always import from src/env.ts to ensure type safety and validation.

Correct Usage:

import { env, TRADING_MODE, IS_SIMULATION_ENABLED } from "@/env";

// Access validated environment variables
const dbUrl = env.DATABASE_URL;
const port = env.PORT;
const isSimulated = IS_SIMULATION_ENABLED;

Incorrect Usage:

// ❌ Don't do this - no validation or type safety
const dbUrl = process.env.DATABASE_URL;

Server Configuration

Variables for backend API server configuration.

number

default:"8081"

Port number for the backend API server. The frontend will proxy /api/* requests to this port during development.

string (URL)

Public server origin URL. Used for callbacks and external integrations.Example: https://autonome.app

string (URL)

default:"http://localhost:8081"

Internal API base URL used by the server for self-referencing endpoints.

string

Comma-separated list of allowed frontend origins for CORS. No trailing slashes.Example: https://autonome.app,https://autonome.vercel.app

Database

string (URL)

PostgreSQL connection string. Required for backend operation but optional for frontend-only deployments on Vercel.Format: postgres://user:password@localhost:5432/autonome

The database URL contains sensitive credentials. Never expose this in client-side code or commit it to version control.

Trading Configuration

Controls trading mode and simulator behavior. See Trading Mode for detailed information.

enum

default:"simulated"

Trading execution mode. Controls whether orders are sent to the real exchange or simulated locally.Values:

simulated - Use local simulator (safe for testing)
live - Execute real trades via Lighter API

number

default:"10000"

Starting capital for the trading simulator in quote currency (USDT).

string

default:"USDT"

Quote currency for simulator positions and P&L calculations.

number

default:"10000"

Interval in milliseconds for simulator to refresh market data and recalculate positions.

Lighter API

Configuration for zkLighter exchange integration (required for live trading).

number

default:"2"

Credential slot index in your zkLighter account. Each account can have multiple API key indexes.

string (URL)

default:"https://mainnet.zklighter.elliot.ai"

Base URL for the Lighter REST API endpoint.

Lighter API credentials provide access to your exchange account. Keep your LIGHTER_API_KEY_INDEX secure and never share it publicly.

AI Provider Keys

Autonome supports multiple AI providers with automatic key rotation for rate limit management.

NVIDIA NIM

string

Primary NVIDIA NIM API key for SQL query planning and data analysis.

string

Additional NIM API key for round-robin rotation.

string

Additional NIM API key for round-robin rotation.

string

Additional NIM API key for round-robin rotation.

OpenRouter

string

Primary OpenRouter API key for accessing various AI models through a unified API.

string

Additional OpenRouter API key for round-robin rotation.