AI-Ready Development That Dreams Are Made Of
This project is a two-in-one:
-
DreamContainer: the AI-ready fully-optimised multi-architecture .devcontainer of your dreams.
-
DreamKit - FastAPI & htmx Template: the modern opinionated architecture to make your Javascript framework nightmares fade away.
DreamContainer is the AI-first development environment you've been dreaming of.
- Claude Code & Github CLI integration out of the box
- MCP tools ecosystem (Puppeteer, Playwright, Browser automation)
- Browser automation ready (screenshots, testing, scraping)
- Security best practices (read-only mounts, isolated packages)
- Production-like development environment
- gh auth survives rebuilds (no more re-login after every rebuild)
- Native ARM64 (Apple Silicon Macs) / Native AMD64 builds (Intel/AMD servers)
- Zero QEMU emulation slowdown (50-80% faster)
- Multi-service orchestration (API, Database, Cache, Frontend)
- Proper volume management (zero host pollution)
- One command setup
- Automatic dependency management
- Health checks included
- Works on any machine immediately
- Smart versioning security updates without breaking changes
# ① Clone your dream environment
git clone https://github.com/ahelme/dream-container.git
cd dream-container
**Customize** (optional)
cp .env.example .env
# Edit .env with your project details
# ② Launch your dreams... 🚀
./scripts/setup.sh
# ③ (Optional) Open in VS Code
code .
# Select "Reopen in Container" when prompted
# ④ Claude Code is installed & ready to vibe...
claude
> Help me build the app of my dreams!
# 💭 Living the dream... start coding immediately!| 😭 Development Hell | 💭 DreamContainer |
|---|---|
| ❌ Breaks after rebuilds | ✅ Persistent authentication |
| ❌ Slow multi-platform builds | ✅ Native ARM64 + AMD64 |
| ❌ Host dependency pollution | ✅ Perfect isolation |
| ❌ Complex authentication setup | ✅ One-command login |
| ❌ Hours of configuration | ✅ 2-minute setup |
Anti-Bureaucracy Architecture
├── 🤖 Dream AI Dev Container (Claude Code + MCP Tools)
├── 🐘 PostgreSQL Database
├── 📦 Cache Layer (Redis/Valkey/KeyDB)
├── 🚀 API Server (FastAPI/Express/Django)
├── ⚡ HTMX Frontend (Zero build complexity!)
└── 🔧 Quality Tools (Black, Prettier, Tests)
Notice what's missing? Webpack, Babel, build scripts, node_modules chaos!
• Claude Code for AI pair programming • MCP tools for automation • Browser testing capabilities • Persistent authentication
• HTMX for dynamic interactions • Tailwind for beautiful styling • No build process needed • Edit and refresh workflow
• FastAPI for modern Python APIs • Automatic OpenAPI documentation • Type validation included • Async support out of the box
• PostgreSQL for reliability • Redis for lightning-fast caching • Persistent volumes for data safety • Connection pooling configured
Zero build complexity
• HTMX + Tailwind + FastAPI/Express backends • Database-driven applications & API-first development • Real-time updates without JavaScript frameworks complexity • HTML & Nginx for the bare essentials!
Claude Code ready
• Claude Code integration out of the box • Jupyter notebooks with HTMX frontends • Data visualization without unnecessary complexity
Production ready
• Microservices architecture • Multi-team collaboration without build conflicts • Security-focused development
Ship fast, iterate faster
• Rapid prototyping without build tools • Full-stack in minutes, not hours • Production-grade from day one: scale as you go
"The best framework is the one you don't need." - DreamOps Philosophy
| 📖 Guide | 🎯 Perfect For |
|---|---|
| 🚀 Quick Start | Living the dream in 2 minutes |
| 🏗️ Architecture | Understanding your dreams |
| ⚙️ Customization | Personalizing your dreams |
| 🔐 Authentication | Setting up dream authentication |
| 🐛 Troubleshooting | When dreams need fixing |
| 🤖 Claude Code | AI-powered dream development |
Choose your dream stack and start immediately:
- FastAPI + HTMX - Modern Python web without frontend complexity
- Django + HTMX - Traditional Python with dynamic UI magic
- Express + HTMX - Node.js backend with zero-build frontend
- Pure HTML + API - Static HTML + Tailwind + API calls
- Data Science - Jupyter + ML library dreams
- AI Chatbot - Claude Code + LangChain dreams
- Computer Vision - OpenCV + PyTorch dreams
- Claude Code Playground - MCP tools sandbox
- Microservices - Docker Compose + Kong dreams
- GraphQL API - Apollo Server setup dreams
- Auth + RBAC - Security-first development
- FastAPI + React - If you enjoy bundler complexity
- Vue + Express - Component-based development
- Next.js Full-Stack - SSR with all the bells and whistles
- Svelte + FastAPI - Compile-time optimized
💡 Dream Tip: Start with HTMX examples for maximum anti-bureaucracy bliss! You can always add React later if your project truly needs it (spoiler: it probably doesn't!).
# Create new dream from this template
gh repo create my-dream-project --template yourname/dream-container
cd my-dream-project
code .git clone https://github.com/yourname/dream-container.git
cd dream-container
# Customize your dreams# Copy just the dream setup
curl -sL https://github.com/yourname/dream-container/archive/main.tar.gz | tar -xz --strip=1 "*/\.devcontainer"- 🐛 Found a nightmare? Report it
- 💡 Have a dream idea? Share it
- 🔧 Want to contribute? Join the dream team
- ⭐ Think its dreamy? Star it and tell your friends!
MIT License - feel free to use this for all your dreams! See LICENSE for details.
Built with 💭 by developers who were tired of development nightmares.
Credits:
Special thanks to:
- The VS Code team for making devcontainer dreams possible
- Anthropic for Claude Code that makes AI dreams real
- The Docker team for multi-platform dream builds
- Everyone who contributed examples and made dreams come true