Add devcontainer setup for AI coding agents

[dsfaccini]

summary

hey guys, this as a draft PR to add a devcontainer config for AI coding agents (claude code, cursor, et al) and just ol' flesh and bone contributors.

I included an install.sh that is used to initialize the devcontainer either in standard mode (default) or full ML dev mode (pytorch etc).

standard takes a couple of minutes on my machine (m4, 24gb) and full ML dev mode more like 10 min.

I recommend using Orbstack instead of Docker Desktop (seems to be easier on my system's resources) but only if you know how to set it up.

lastly, I'm not an expert in devcontainers so this is largely built by claude itself but I built it on my machine multiple times until it was smooth enough, so I hope that's your experience too. Otherwise let me know!

facts

• Python 3.12 environment with uv, pre-commit, deno
• Placeholder for Optional services: Ollama (local models), PostgreSQL, pgvector
• Modern git configuration (something about source references)
• Platform compatibility (x86_64 via emulation on ARM64, this was relevant for the full ML setup)
• Docs with troubleshooting and setup instructions

files

• .devcontainer/Dockerfile - container image with all dev tools
• .devcontainer/devcontainer.json - VS Code configuration and settings
• .devcontainer/docker-compose.yml - service orchestration
• .devcontainer/.env.example - API keys template
• .devcontainer/mcp-proxy-config.json - MCP server integration
• .devcontainer/README|AGENTS.md - docs and agent guidelines

more facts

• Uses modern git configuration (environment variables, auto credential forwarding)
• Includes optional services for examples (Ollama, PostgreSQL, pgvector)
• Platform-specific configuration for ARM64/x86_64 compatibility
• Latest stable versions (Node 24, PostgreSQL 18, pgvector pg18)

testing

• Builds successfully on macOS Apple Silicon (via x86_64 emulation)
• All dependencies install correctly via `make install`
• Pre-commit hooks setup works
• Git operations work with modern configuration
• Configurations for optional services (Ollama, PostgreSQL) are available in the compose, but I haven't tested them

references

This implementation follows best practices from:

• VS Code: Sharing Git credentials
• Anthropic: Development containers