TTA.dev

TTA.dev - AI Development Toolkit

Production-ready agentic primitives and workflow patterns for building reliable AI applications.

CI Quality Python 3.11+ Code style: Ruff Type checked: Pyright

🎯 What is TTA.dev?

TTA.dev is a curated collection of battle-tested, production-ready components for building reliable AI applications. Every component here has:

Philosophy: Only proven code enters this repository.

📦 Packages

tta-workflow-primitives

Production-ready composable workflow primitives for building reliable, observable agent workflows.

Features:

Installation:

pip install tta-workflow-primitives

Quick Start:

from tta_workflow_primitives import RouterPrimitive, CachePrimitive

# Compose workflow with operators
workflow = (
    validate_input >>
    CachePrimitive(ttl=3600) >>
    process_data >>
    generate_response
)

# Execute
result = await workflow.execute(data, context)

📚 Full Documentation

dev-primitives

Development utilities and meta-level primitives for building robust development processes.

Features:

Installation:

pip install dev-primitives

📚 Full Documentation

🚀 Quick Start

Installation

# Install with pip
pip install tta-workflow-primitives dev-primitives

# Or with uv (recommended)
uv pip install tta-workflow-primitives dev-primitives

Basic Workflow Example

from tta_workflow_primitives import WorkflowContext
from tta_workflow_primitives.core.base import LambdaPrimitive

# Define primitives
validate = LambdaPrimitive(lambda x, ctx: {"validated": True, **x})
process = LambdaPrimitive(lambda x, ctx: {"processed": True, **x})
generate = LambdaPrimitive(lambda x, ctx: {"result": "success"})

# Compose with >> operator
workflow = validate >> process >> generate

# Execute
context = WorkflowContext(workflow_id="demo", session_id="123")
result = await workflow.execute({"input": "data"}, context)

print(result)  # {"validated": True, "processed": True, "result": "success"}

🏗️ Architecture

TTA.dev follows a composable, modular architecture:

┌─────────────────────────────────────────────────────┐
│                  Your Application                   │
└─────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────┐
│           tta-workflow-primitives                   │
│  ┌────────────┬──────────────┬─────────────────┐   │
│  │   Router   │    Cache     │    Timeout      │   │
│  ├────────────┼──────────────┼─────────────────┤   │
│  │  Parallel  │ Conditional  │     Retry       │   │
│  └────────────┴──────────────┴─────────────────┘   │
└─────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────┐
│              dev-primitives                         │
│  ┌────────────┬──────────────┬─────────────────┐   │
│  │  Logging   │   Retries    │   Test Utils    │   │
│  └────────────┴──────────────┴─────────────────┘   │
└─────────────────────────────────────────────────────┘

📚 Documentation

Cost Optimization

Additional Resources

🧪 Testing

All packages maintain 100% test coverage with comprehensive test suites.

# Run all tests
uv run pytest -v

# Run with coverage
uv run pytest --cov=packages --cov-report=html

# Run specific package tests
uv run pytest packages/tta-workflow-primitives/tests/ -v

🛠️ Development

Prerequisites

Setup

# Clone repository
git clone https://github.com/theinterneti/TTA.dev
cd TTA.dev

# Install dependencies
uv sync --all-extras

# Run tests
uv run pytest -v

# Run quality checks
uv run ruff format .
uv run ruff check . --fix
uvx pyright packages/

VS Code Workflow

We provide VS Code tasks for common operations:

  1. Press Cmd/Ctrl+Shift+P
  2. Type “Task: Run Task”
  3. Select from:
    • 🧪 Run All Tests
    • ✅ Quality Check (All)
    • 📦 Validate Package
    • 🔍 Lint Code
    • ✨ Format Code

See full task list

🤝 Contributing

We welcome contributions! However, only battle-tested, proven code is accepted.

Contribution Criteria

Before submitting a PR, ensure:

Contribution Workflow

  1. Create feature branch

    git checkout -b feature/add-awesome-feature

  2. Make changes and validate

    ./scripts/validate-package.sh <package-name>

  3. Commit with semantic message

    git commit -m "feat(package): Add awesome feature"

  4. Create PR

    gh pr create --title "feat: Add awesome feature"

  5. Squash merge after approval

See full contribution guide (Coming soon)

📋 Code Quality Standards

Formatting

Linting

Type Checking

Testing

Documentation

🚦 CI/CD

All PRs automatically run:

Merging requires all checks to pass.

📊 Project Status

Current Release: v0.1.0 (Initial)

Package Version Tests Coverage Status
tta-workflow-primitives 0.1.0 12/12 ✅ 100% 🟢 Stable
dev-primitives 0.1.0 TBD TBD 🟢 Stable

Roadmap

🔗 Related Projects

📄 License

MIT License - see LICENSE for details

🙏 Acknowledgments

Built with:

📧 Contact

⭐ Star History

If you find TTA.dev useful, please consider giving it a star! ⭐

Last Updated: 2025-10-27 Status: 🚀 Ready for migration