Skip to main content

Environment Variables

Complete reference for all configuration options.

Required​

VariableDescriptionExample
DATABASE_URLPostgreSQL connection stringpostgresql://user:pass@localhost:5432/argus

AI / LLM​

VariableDescriptionDefault
NEAR_AI_API_KEYNear AI API key for briefings-
NEAR_AI_MODELModel for briefing generationdeepseek-ai/DeepSeek-V3.1
NEAR_AI_MAX_TOKENSMax tokens for responses4096

Telegram​

VariableDescriptionDefault
TELEGRAM_BOT_TOKENBot token from BotFather-
TELEGRAM_CHAT_IDTarget chat for delivery-
TELEGRAM_CHAT_IDSMultiple chats (comma-separated)-

Server​

VariableDescriptionDefault
PORTHTTP server port3000
NODE_ENVEnvironment modedevelopment
LOG_LEVELLogging verbosityinfo

Ingestion​

VariableDescriptionDefault
INGEST_INTERVAL_MINUTESHow often to fetch sources30
INGEST_TIMEOUT_MSFeed fetch timeout30000
INGEST_MAX_ARTICLESMax articles per source per run50

Briefings​

VariableDescriptionDefault
BRIEFING_SCHEDULECron for auto-generation0 10,23 * * *
BRIEFING_DEFAULT_HOURSDefault time window24
BRIEFING_MIN_CONFIDENCEMinimum article confidence0.7
BRIEFING_DELIVERY_CHANNELAuto-delivery channel-

Verification​

VariableDescriptionDefault
VERIFY_ENABLEDEnable AI verificationtrue
VERIFY_MIN_SOURCESSources needed for high confidence2

Webhooks​

VariableDescriptionDefault
WEBHOOK_URLURL for event notifications-
WEBHOOK_SECRETShared secret for signatures-
WEBHOOK_EVENTSEvents to send (comma-separated)briefing.generated

Example .env​

# Database
DATABASE_URL=postgresql://argus:password@localhost:5432/argus

# Near AI
NEAR_AI_API_KEY=sk_live_xxxxx
NEAR_AI_MODEL=deepseek-ai/DeepSeek-V3.1

# Telegram
TELEGRAM_BOT_TOKEN=123456:ABC-DEF
TELEGRAM_CHAT_ID=666796372

# Server
PORT=3000
NODE_ENV=production
LOG_LEVEL=info

# Scheduling
INGEST_INTERVAL_MINUTES=30
BRIEFING_SCHEDULE="0 10,23 * * *"
BRIEFING_DELIVERY_CHANNEL=telegram

Security Notes​

  • Never commit .env to version control
  • Use secrets management in production
  • Rotate API keys periodically
  • Use strong database passwords