Initial project setup

.env.example

@@ -0,0 +1,60 @@
+# Facebook Messenger Configuration
+# Get these from your Facebook App settings at https://developers.facebook.com/
+FACEBOOK_PAGE_ACCESS_TOKEN=your_page_access_token_here
+FACEBOOK_VERIFY_TOKEN=your_verify_token_here
+FACEBOOK_APP_SECRET=your_app_secret_here  # Optional, for signature verification
+
+# Supabase Configuration
+# Get these from your Supabase project settings
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_SERVICE_KEY=your_service_role_key_here
+
+# GitHub Copilot SDK Configuration
+# Default Copilot CLI host (usually runs on localhost:5909)
+COPILOT_CLI_HOST=http://localhost:5909
+# Enable/disable Copilot SDK (set to False to use OpenAI fallback)
+COPILOT_ENABLED=True
+
+# OpenAI API Key (fallback when Copilot is unavailable)
+# Get from https://platform.openai.com/api-keys
+OPENAI_API_KEY=your_openai_api_key_here
+
+# Environment
+# Options: local, railway, prod
+ENV=local
+
+# Railway Configuration (automatically set by Railway)
+# PORT=8000  # Railway sets this automatically, don't override
+
+## Variable Descriptions
+
+### Facebook Configuration
+# FACEBOOK_PAGE_ACCESS_TOKEN: Long-lived page access token for your Facebook Page.
+#   Generate this in Facebook App Settings → Messenger → Access Tokens.
+# FACEBOOK_VERIFY_TOKEN: Custom token you create for webhook verification.
+#   Must match the token you set in Facebook App webhook settings.
+# FACEBOOK_APP_SECRET: Optional. Used for signature verification of incoming webhook requests.
+
+### Supabase Configuration
+# SUPABASE_URL: Your Supabase project URL. Found in Project Settings → API.
+# SUPABASE_SERVICE_KEY: Service role key (has admin privileges).
+#   Found in Project Settings → API. **Keep this secret!**
+
+### Copilot SDK Configuration
+# COPILOT_CLI_HOST: Base URL for the GitHub Copilot CLI. Default is http://localhost:5909.
+# COPILOT_ENABLED: Boolean flag to enable/disable Copilot SDK.
+#   Set to False to always use OpenAI fallback.
+
+### OpenAI Configuration
+# OPENAI_API_KEY: API key for OpenAI (used as fallback when Copilot is unavailable).
+#   Get from https://platform.openai.com/api-keys
+
+### Environment
+# ENV: Current environment. Options: local, railway, prod.
+#   Used for environment-specific behavior.
+
+## Security Notes
+# - Never commit .env file to version control
+# - Use .env.example as a template only
+# - Rotate secrets regularly
+# - Use different tokens/keys for different environments

.gitignore

@@ -0,0 +1,54 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+*.pyc
+*.pyo
+*.pyd
+.Python
+build/
+dist/
+wheels/
+*.egg-info
+.eggs/
+
+# Virtual environments
+.venv
+venv/
+ENV/
+env/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Database
+*.db
+*.sqlite
+*.sqlite3

.python-version

@@ -0,0 +1 @@
+3.12.8