Configuration

Reference for Suitcase's environment variables and configuration files.

Environment Variables (.env)

Copy .env.example to .env and configure:

# ── LLM Configuration ──────────────────────────────
# Provider mode: openai-compatible or anthropic-compatible
LLM_PROVIDER=local_openai_compatible

# Base URL of your LLM endpoint
LLM_BASE_URL=http://127.0.0.1:1234/v1

# Model name/ID as recognized by your endpoint
LLM_MODEL=qwen3-coder-30b

# API key (if required by your endpoint)
LLM_API_KEY=sk-...

# Timeout in seconds for LLM requests
LLM_TIMEOUT_SECONDS=60

# Temperature for LLM responses (0.0-2.0)
LLM_TEMPERATURE=0.1

# ── GitHub (Optional) ──────────────────────────────
# Personal access token for GitHub API
GITHUB_TOKEN=github_pat_...

# ── Discord (Optional) ─────────────────────────────
# Enable Discord bot integration
DISCORD_ENABLED=true

# Discord bot token
DISCORD_BOT_TOKEN=your-bot-token

# Your Discord user ID (for DMs)
DISCORD_TARGET_USER_ID=1170384908087214222

# Suitcase Runtime — enables the agent bridge
# Both SUITCASE_USE_SYNAX and AUTOCAREER_USE_SYNAX are supported
SUITCASE_USE_SYNAX=true

# ── Cloudflare Access (Optional) ───────────────────
# If your LLM endpoint is behind Cloudflare Zero Trust,
# add these headers through the setup UI (not .env directly)
# CF-Access-Client-Id=xxx.apps.cloudflareaccess.com
# CF-Access-Client-Secret=xxx

Configuration Files

File	Purpose
.env	Environment variables — LLM config, tokens, feature flags
app/data/applications.db	SQLite database — career data, evidence, job leads
suitcase_world/SOUL.md	Agent voice and boundaries
suitcase_world/SELF.md	Agent self-model and operating rules
suitcase_world/WORLD.md	World laws and safety boundaries
suitcase_world/CHECKINS.md	Daily check-in policy

Serving the Frontend

The React frontend is a SPA (Single Page Application). Build it once:

cd frontend
npm install
npm run build

The FastAPI server serves the built files at http://localhost:8000/. No separate frontend server needed in production.

For development with hot reload:

cd frontend
npm run dev   # starts Vite dev server on :5173

Resetting

From the admin console, click Reset database to clear all career data and start fresh. This:

• Clears the SQLite database
• Removes session storage (resets the intro flow)
• Reloads the page to start the setup wizard again

Your .env configuration is preserved — you won't need to re-enter your LLM settings.