Create modern Python projects with uv, ruff, mypy, FastAPI, AI integration, and Queen Claude foundation - universal for APIs, AI applications, CLI tools, and automation
npm install @kenkaiiii/queen-pythonComplete Python project generator with multiple pathways - CLI tools, REST APIs, AI applications, automation scripts, and libraries.
Python Queen is a dynamic project generator that creates complete, production-ready Python applications from scratch. It's NOT a template repository - it's a generator that builds exactly what you need based on your choices.
1. Setup Python Project:
```
User: /1-setup-python
Claude: What type of Python project?
User: 2 (for REST API)
Claude: Creates complete FastAPI project
2. Add Database (Optional):
``
User: /2-setup-database
Claude: Database type? (1=SQLite, 2=PostgreSQL)
User: 2
Claude: Adds SQLAlchemy + migrations
3. Add AI (Optional):
``
User: /3-setup-ai
Claude: AI Provider? (1=OpenAI, 2=Anthropic, 3=Local)
User: 1
Claude: Adds OpenAI integration
`javascript
// Create a FastAPI project
await mcp_queen_mcp_setup_python_foundation({
project_path: "/path/to/my-api",
project_type: "api",
database_type: "postgresql"
});
// Add database
await mcp_queen_mcp_setup_python_database({
project_path: "/path/to/my-api",
database_type: "postgresql",
auth_type: "simple"
});
// Add AI capabilities
await mcp_queen_mcp_setup_python_ai({
project_path: "/path/to/my-api",
ai_provider: "openai",
vector_store: "chroma"
});
`
my-project/
โโโ src/
โ โโโ my_project/
โ โโโ __init__.py
โ โโโ main.py # Entry point
โ โโโ core/
โ โ โโโ config.py # Pydantic settings
โ โ โโโ logging.py # Structured logging
โ โโโ utils/ # Utility functions
โโโ tests/
โ โโโ unit/
โ โโโ integration/
โโโ .env.example # Environment template
โโโ pyproject.toml # Dependencies & config
โโโ README.md # Complete documentation
โโโ .gitignore
`$3
CLI Tool:
-
commands/ - Typer subcommands
- models/ - Data models
- Rich tables and progress bars
- YAML config supportREST API:
-
routers/ - API endpoints
- models/ - SQLAlchemy models
- middleware/ - CORS, auth
- Swagger UI at /docsAI Application:
-
agents/ - AI agent definitions
- prompts/ - Prompt templates
- tools/ - Function tools
- Provider integrationsAutomation:
-
jobs/ - Scheduled tasks
- services/ - Business logic
- Scheduler configuration
- Job monitoringLibrary:
- Proper package structure
-
__version__.py
- Build configuration
- PyPI metadataRunning Generated Projects
$3
`bash
cd my-cli-tool
uv run python -m src.my_cli_tool.main --help
`$3
`bash
cd my-api
uv run uvicorn src.my_api.main:app --reload
API at http://localhost:8000
Docs at http://localhost:8000/docs
`$3
`bash
cd my-ai-app
export OPENAI_API_KEY="sk-..."
uv run python -m src.my_ai_app.main
`$3
`bash
cd my-automation
uv run python -m src.my_automation.main
Runs scheduler with configured jobs
`$3
`bash
cd my-library
uv run pytest # Run tests
uv run python -m build # Build package
uv run twine upload dist/* # Upload to PyPI
`Development Commands
All projects include:
`bash
Dependency management
uv add package-name # Add dependency
uv add --dev package-name # Add dev dependency
uv sync # Install all depsCode quality
uv run ruff check . # Lint code
uv run ruff format . # Format code
uv run mypy src/ # Type checkingTesting
uv run pytest # Run tests
uv run pytest --cov # With coverage
uv run pytest -v # Verbose outputDatabase (if applicable)
uv run alembic revision --autogenerate -m "message" # Create migration
uv run alembic upgrade head # Apply migrations
`Environment Configuration
Each project includes
.env.example:`bash
API Configuration
API_HOST=0.0.0.0
API_PORT=8000
DEBUG=falseDatabase (if added)
DATABASE_URL=postgresql://user:pass@localhost/dbnameAI Provider (if added)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
OLLAMA_HOST=http://localhost:11434Security (if auth enabled)
SECRET_KEY=your-secret-key
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30
``- Python 3.11 or higher
- uv package manager
- Git (for version control)
1. You Choose: Select your project type (CLI, API, AI, etc.)
2. Generator Creates: Complete project structure with all files
3. Dependencies Install: Via uv automatically
4. Ready to Run: Immediately functional application
This is NOT a template you clone. It's a generator that creates fresh projects tailored to your specific needs.
Python Queen is part of the larger Queen Claude ecosystem:
- Queen Claude: Main autonomous development system
- Python Queen: Python project generator (this)
- Next.js Queen: Next.js/React project generator
- Queen MCP: Model Context Protocol server
All work together to provide complete full-stack development capabilities.
MIT