Configuration

Orbit supports flexible configuration for local and cloud deployments. Key configuration areas include:

• Python environment: Add your venv to VS Code's python.analysis.extraPaths and mypy-type-checker.path for better code intelligence.
• Environment variables: Set AWS and application-specific variables in your .env or VS Code launch.json.
• Docker Compose: Adjust docker/compose.yml for service ports, volumes, and credentials.
• Database: Use Liquibase for version-controlled schema changes. See database/ for changelogs.

Example: VS Code settings

{
  "python.analysis.extraPaths": [
    "${workspaceFolder}/lib/python3.13/site-packages"
  ],
  "mypy-type-checker.path": "${workspaceFolder}/lib/python3.13/site-packages"
}

Example: AWS Credentials in launch.json

{
  "env": {
    "AWS_CONFIG_PARAMETER_NAME": "/ai/config",
    "AWS_ACCESS_KEY_ID": "***",
    "AWS_SECRET_ACCESS_KEY": "***",
    "AWS_SESSION_TOKEN": "***",
    "AWS_DEFAULT_REGION": "us-east-1",
    "LOG_LEVEL": "INFO"
  }
}

Jupyter Notebooks

Set Notebook File Root in VS Code to allow notebooks to import local modules:

${fileDirname}/..

Advanced

See the Docker and AWS credential vendor documentation for advanced configuration scenarios.