Configuration
Environment variables, settings, and GitHub App setup for Syntropic137.
Syntropic137 uses environment variables for configuration. Copy .env.example to .env
and customize as needed.
Core Settings
| Variable | Default | Description |
|---|---|---|
APP_ENVIRONMENT | development | Runtime environment (development, staging, production) |
DATABASE_URL | — | PostgreSQL connection string |
REDIS_URL | — | Redis connection string |
API_HOST | 0.0.0.0 | API server bind address |
API_PORT | 8000 | API server port |
GitHub App
Syntropic137 integrates with GitHub through a GitHub App for receiving webhook events and managing repositories.
Setup
Run the GitHub App setup via the CLI:
npx @syntropic137/setup github-appSee GitHub Integration for the full setup guide including trigger rules and webhook configuration. For secret storage details, see Secrets Management.
Environment Variables
| Variable | Description |
|---|---|
GITHUB_APP_ID | GitHub App ID |
GITHUB_APP_PRIVATE_KEY | PEM-encoded private key |
GITHUB_WEBHOOK_SECRET | Webhook verification secret |
Agent Configuration
| Variable | Default | Description |
|---|---|---|
AGENT_WORKSPACE_DIR | /tmp/syn-workspaces | Base directory for agent workspaces |
AGENT_TIMEOUT | 3600 | Maximum agent execution time (seconds) |
AGENT_MAX_CONCURRENT | 4 | Maximum concurrent agent sessions |
Event Polling
Syntropic137 polls the GitHub Events API as a zero-config fallback when webhooks are unavailable. Polling is enabled by default — no tunnel setup required. See Event Ingestion for how the hybrid approach works.
| Variable | Default | Description |
|---|---|---|
SYN_POLLING_DISABLED | false | Disable Events API polling entirely |
SYN_POLLING_POLL_INTERVAL_SECONDS | 60.0 | Active polling interval (seconds) |
SYN_POLLING_SAFETY_NET_INTERVAL_SECONDS | 300.0 | Safety net polling interval (seconds) |
SYN_POLLING_WEBHOOK_STALE_THRESHOLD_SECONDS | 1800.0 | Seconds before switching to active polling |
SYN_POLLING_DEDUP_TTL_SECONDS | 86400 | Redis dedup key TTL (seconds) |
See .env.example in the repository for the complete list of configuration
options.
Syntropic137 Docs v0.18.0 · Last updated March 2026