Environment Variables
All configuration variables for the HyperSaaS backend.
Environment variables are stored in .envs/.local/ for development and .envs/.production/ for production. The backend uses django-environ to load them.
| Variable | Default | Description |
|---|
DJANGO_SETTINGS_MODULE | config.settings.local | Settings module to use |
DJANGO_SECRET_KEY | — | Secret key (auto-generated in dev) |
DJANGO_DEBUG | True (local) | Enable debug mode |
DJANGO_ALLOWED_HOSTS | ["localhost", "0.0.0.0", "127.0.0.1"] | Allowed host headers |
DATABASE_URL | postgres://... | PostgreSQL connection string |
REDIS_URL | redis://redis:6379/0 | Redis connection string |
| Variable | Default | Description |
|---|
OPENAI_API_KEY | — | OpenAI API key (required for embeddings) |
GOOGLE_API_KEY | — | Google AI API key |
ANTHROPIC_API_KEY | — | Anthropic API key |
DEFAULT_AI_PROVIDER | google | Default LLM provider |
DEFAULT_AI_MODEL | gemini-2.5-pro-preview-05-06 | Default model identifier |
SERPAPI_API_KEY | — | SerpAPI key for web search tool |
WEATHERAPI_COM_API_KEY | — | WeatherAPI key for weather tool |
GOOGLE_MAPS_API_KEY | — | Google Maps key for location tool |
| Variable | Default | Description |
|---|
STRIPE_API_SECRET | — | Stripe secret key |
STRIPE_PUBLISHABLE_KEY | — | Stripe publishable key |
STRIPE_ENDPOINT_SECRET | — | Stripe webhook endpoint secret |
STRIPE_WEBHOOK_SECRET | — | Stripe webhook signing secret |
STRIPE_PRODUCT_ID | — | Default Stripe product ID |
| Variable | Default | Description |
|---|
DJANGO_AWS_ACCESS_KEY_ID | — | AWS access key |
DJANGO_AWS_SECRET_ACCESS_KEY | — | AWS secret key |
DJANGO_AWS_STORAGE_BUCKET_NAME | — | S3 bucket name |
AWS_S3_REGION_NAME | — | S3 region |
| Variable | Default | Description |
|---|
RESEND_API_KEY | — | Resend API key for transactional email |
DEFAULT_FROM_EMAIL | support@kognitivatlas.com | Sender email address |
| Variable | Default | Description |
|---|
FRONT_END_BASE_URL | http://localhost:3000 | Frontend URL (for email links, CORS) |
BACK_END_BASE_URL | http://localhost:8000/ | Backend URL |
| Variable | Default | Description |
|---|
AGENT_ASYNC_ENABLED | False | Enable async agent execution via Celery |
DEFAULT_FREE_USAGE_CREDIT | 1.0 | Free credit for new users (USD) |
| Variable | Default | Description |
|---|
DOCUMENT_EMBEDDING_MODEL | text-embedding-3-small | OpenAI embedding model |
DOCUMENT_EMBEDDING_DIMENSIONS | 1536 | Vector dimensions |
DOCUMENT_EMBEDDING_BATCH_SIZE | 512 | Texts per embedding API call |
DOCUMENT_CHUNK_MAX_TOKENS | 512 | Max tokens per document chunk |
DOCUMENT_MAX_UPLOAD_SIZE | 52428800 | Max upload size in bytes (50 MB) |
DOCUMENT_PRESIGNED_URL_EXPIRY | 3600 | Presigned URL TTL in seconds |