Create Python Project ⭐

An all-in-one Python project creator with intelligent setup based on project description and built-in AI integration.

Features

Interactive CLI-based setup with rich colorful interface and intelligent defaults
AI-powered project type detection based on your project description
Multiple AI provider integrations including OpenAI, Anthropic, Perplexity, DeepSeek, and Gemini
Support for multiple project types (Web, Data Analysis, API Integration, etc.)
AI-recommended technology selection with customizable options
Project structure visualization with organized, best-practice directory layouts
VS Code integration with workspace files and task definitions
Comprehensive logging system with detailed error tracking
Docker, CI/CD, and pre-commit hook configuration options
Git repository setup with dual remote support (GitHub and GitLab)

Installation

# Clone the repository
git clone https://github.com/MichaelNewham/create_python_project.git
cd create_python_project

# Install with Poetry (recommended)
poetry install

# Or with pip in a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Configuration

This project requires some configuration for MCP and VS Code integration:

Environment Variables: Copy the example .env file and fill in your API keys
```
cp .env.example .env
# Edit .env with your API keys
```

VS Code Settings:

cp .vscode/settings.json.template .vscode/settings.json
cp .vscode/mcp.json.template .vscode/mcp.json

For more information on security best practices:

Usage

# With Poetry
poetry run python -m create_python_project.create_python_project

# Or after installing the package
create-python-project

The interactive process will guide you through:

Setting up your project name and location
Selecting an AI provider for recommendations
Describing your project for AI analysis
Selecting from AI-recommended technologies
Configuring additional options (Docker, CI/CD, etc.)
Creating the project with the optimal structure

Development

# Install all dependencies including development dependencies
poetry install --with dev

# Run type checking to verify all issues are fixed
poetry run mypy --config-file=.config/mypy.ini src/create_python_project

# Test the application
poetry run python -m create_python_project.create_python_project

# Run AI integration tests
poetry run pytest tests/test_ai_integration.py -v

# Format code with Black
poetry run black src/create_python_project

Project Organization

The project follows a clean organization structure:

... (truncated for brevity) ...

OpenAI: GPT-4o-mini and other OpenAI models
Anthropic: Claude 3.7 Sonnet and other Claude models
Perplexity: Sonar model for project analysis
DeepSeek: DeepSeek Reasoner model - Advanced reasoning for complex problem analysis
Gemini: Gemini 2.5 Pro and other Gemini models

Each provider helps with:

Project type detection based on your description
Recommending appropriate technologies and libraries
Suggesting optimal project structure
Providing implementation guidance