Skip to main content

PyTaskAI v0.3.0

Minimal AI-powered task management with MCP integration and hexagonal architecture

Python 3.8+ License: MIT

🎯 Project Status: ✅ COMPLETE - PRODUCTION READY

🚀 Hexagonal architecture implementation completed successfully!

  • Achievement: Clean 2900-line codebase with 6 essential MCP tools
  • Quality: 168 tests passing, 80% coverage, SOLID principles
  • Architecture: Complete hexagonal (ports & adapters) implementation

🏗️ New Architecture: Hexagonal (Ports & Adapters)

pytaskai/
├── domain/               # 🔵 CORE - Pure business logic
│   ├── entities/         # Task, SubTask business entities  
│   ├── repositories/     # Abstract interfaces (ports)
│   └── services/         # Domain services
├── application/          # 🟡 USE CASES - Orchestration
│   ├── use_cases/        # Application use cases
│   ├── dto/              # Data Transfer Objects
│   └── interfaces/       # Ports for external services
├── infrastructure/       # 🟢 IMPLEMENTATION - Details
│   ├── persistence/      # SQLite implementation
│   └── external/         # OpenAI service
└── adapters/            # 🟠 EXTERNAL - User interfaces
    ├── mcp/              # MCP server adapter
    └── cli/              # CLI adapter

📊 Achievement Metrics (vs Previous)

Aspect Previous ✅ Achieved
Total Lines 5000+ 2900 lines
Dependencies 26+ 6 core
MCP Tools 27 6 essential
AI Providers 9 1 (OpenAI)
Test Coverage None 80% (168 tests)
Architecture Monolithic Hexagonal

🚀 Quick Start

# Install
pip install -e .

# Setup environment
export OPENAI_API_KEY="your-key-here"

# CLI usage
pytaskai init                         # Initialize database
pytaskai task add "My new task"       # Add task
pytaskai task list                    # List tasks
pytaskai task generate 1              # AI subtask generation

# Run tests
python -m pytest pytaskai/tests/     # All 168 tests

# MCP integration (Claude Code)
# Configure in ~/.claude.json or MCP client

🔧 Essential Features (6 MCP Tools)

  1. list_tasks - List tasks with filters
  2. get_task - Get task details
  3. add_task - Create new task
  4. update_task - Modify task
  5. delete_task - Remove task
  6. generate_subtasks - AI-powered task breakdown

📊 Dependencies (Minimal)

dependencies = [
    "fastmcp>=0.3.0",      # MCP server
    "pydantic>=2.0.0",     # Data models
    "sqlalchemy>=2.0.0",   # Database
    "openai>=1.0.0",       # AI (OpenAI only)
    "click>=8.0.0",        # CLI
    "python-dotenv>=1.0.0" # Config
]

🏁 Implementation Status

✅ All Milestones Completed:

  • MILESTONE 1: Domain Layer - Entities, value objects, repository interfaces
  • MILESTONE 2: Application Layer - Use cases, DTOs, dependency injection
  • MILESTONE 3: Infrastructure Persistence - SQLite repository implementation
  • MILESTONE 4: MCP Adapter - FastMCP server with 6 essential tools
  • MILESTONE 5: Infrastructure AI - OpenAI service integration
  • MILESTONE 6: CLI Adapter - Click-based command line interface
  • MILESTONE 7: Integration & Testing - E2E tests, architecture validation

🎯 Quality Metrics Achieved:

  • 168 tests passing with 80% code coverage
  • Zero business logic duplication between CLI and MCP adapters
  • Complete hexagonal architecture with proper dependency inversion
  • SOLID principles compliance validated through architecture tests

🎯 Design Principles

  • SOLID Principles: Rigorously applied
  • DRY Implementation: Zero code duplication
  • Hexagonal Architecture: Clean separation of concerns
  • Domain-Driven Design: Business logic in domain layer
  • Test-Driven: Every layer fully testable
  • Incremental: Each milestone is complete and functional

🤝 Contributing

This project now has a stable hexagonal architecture foundation! Contributions are welcome:

  1. Fork and clone the repository
  2. Install development dependencies: pip install -e ".[dev]"
  3. Run tests: python -m pytest pytaskai/tests/
  4. Follow architecture: Maintain hexagonal architecture principles
  5. Submit PR with tests and documentation

See CLAUDE.md for detailed development guidelines.

📄 License

MIT License - see LICENSE.md for details.


PyTaskAI v0.3.0 - Production-ready hexagonal architecture implementation complete! 🎉

Metadata

Release files for pytaskai 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytaskai 0.3.0
File Size Uploaded Provenance Actions
pytaskai-0.3.0.tar.gz 99.9 kB Without provenance Details for pytaskai-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pytaskai 0.3.0
File Interpreter ABI Platform Actions
pytaskai-0.3.0-py3-none-any.whl Python 3 none any Details for pytaskai-0.3.0-py3-none-any.whl

Total release size: 223.6 kB

Release files / pytaskai-0.3.0.tar.gz

Download URL pytaskai-0.3.0.tar.gz
Size 99.9 kB
Tags Source
SHA-256 checksum
How to use checksums
054544d66aed2f6a4876cc875ab0a8818667dbd1faf0ce3bde9ca5528b6d20b4
BLAKE2b-256 checksum
How to use checksums
6f636a71c92615a10c61a305a719ebf677aab1e1e78b79428578f7ca468e2bc3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release files / pytaskai-0.3.0-py3-none-any.whl

Download URL pytaskai-0.3.0-py3-none-any.whl
Size 123.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4f43c22004ce473986aee07bbd3782cb8c78ddb1439bd11ffd036185a4757e14
BLAKE2b-256 checksum
How to use checksums
78d92bf7aa833e693200c2c078c90dc55a018a2e50581ca11652554bc3f156b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Security for pytaskai 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page