Automation and AI assistant orchestration utilities: a minimal Python 3.12+ toolkit scaffold for building and coordinating GitHub Copilot / LLM-driven workflows.
. # Repository root
├── .editorconfig # Editor formatting baseline
├── .gitignore # Git ignore patterns
├── .pre-commit-config.yaml # Pre-commit hook definitions (lint, format, etc.)
├── .tool-versions # asdf toolchain pins (python, etc.)
├── LICENSE # MIT license
├── AGENTS.md # Root agent orchestration & README authoring rules
├── git-conventional-commits.yaml # Conventional commit message lint configuration
├── pyproject.toml # Project metadata, dependencies, build config (hatchling + uv)
├── deploy/ # Deployment artifacts (LiteLLM config & compose stack)
│ ├── docker-compose.yaml # Minimal LiteLLM + Postgres compose (no Redis)
│ ├── litellm-config.yaml # LiteLLM routing & model configuration
│ └── AGENTS.md # Deployment-specific agent guidance (docker-compose, Colima notes)
├── src/ # All Python source (single-source layout root)
│ ├── AGENTS.md # Python style & tooling guide (authoritative technical rules)
│ └── copilot_agents/ # Primary package namespace
│ └── __init__.py # Package marker / version exposure placeholder
└── .github/ # GitHub configuration & AI workflow guardrails (workflows, instructions)
- Language: Python 3.12
- Environment / dependency manager: uv (with asdf for runtime installation)
- Build backend: hatchling
- Lint & format: Ruff
- Testing: pytest
- Env management: direnv (+
.envrcpattern)
# Install asdf & required plugins (if not already)
# macOS (Homebrew):
# brew install asdf
# Ensure python 3.12 toolchain
asdf install
# Sync dependencies (creates .venv)
uv sync
# Run lint + format check
uv run ruff check .
uv run ruff format .
# Run tests (none yet; scaffold command)
uv run pytest -q