Deployment Overview

from src.tinkerer import Tinkerer

# Build a solution
tinkerer = Tinkerer()
solution = tinkerer.evolve("Create a sentiment analysis API")

# Deploy it (AUTO selects best strategy)
software = tinkerer.deploy(solution)

# Use it
result = software.run({"text": "I love this product!"})
print(result)
# {"status": "success", "output": {"sentiment": "positive"}}

# Clean up
software.stop()

# Deploy
software = tinkerer.deploy(solution, strategy=DeployStrategy.DOCKER)

# Run
result = software.run({"text": "hello"})

# Stop (terminates container/cloud deployment)
software.stop()

# Restart (re-creates container/re-deploys to cloud)
software.start()

# Run again after restart
result = software.run({"text": "world"})

# Final cleanup
software.stop()

from src.deployment import DeployStrategy

# Force a specific deployment target
software = tinkerer.deploy(solution, strategy=DeployStrategy.MODAL)
software = tinkerer.deploy(solution, strategy=DeployStrategy.DOCKER)
software = tinkerer.deploy(solution, strategy=DeployStrategy.LOCAL)

# Auto-cleanup when done
with tinkerer.deploy(solution) as software:
    result = software.run({"input": "data"})
    print(result)
# software.stop() called automatically

from src.deployment import DeploymentFactory, DeployStrategy, DeployConfig

config = DeployConfig(
    solution=solution,
    env_vars={"API_KEY": "xxx"},
    timeout=300,
)

software = DeploymentFactory.create(DeployStrategy.AUTO, config)

┌─────────────────────────────────────────────────────────────────────────┐
│  Phase 1: SELECTION                                                     │
│  ─────────────────                                                      │
│  SelectorAgent analyzes your code and chooses the best strategy         │
│  (skipped if you specify a strategy explicitly)                         │
└─────────────────────────────────────────────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────────┐
│  Phase 2: ADAPTATION                                                    │
│  ───────────────────                                                    │
│  AdapterAgent transforms your code for the target platform:             │
│  - Creates deployment files (Dockerfile, modal_app.py, etc.)            │
│  - Adds entry point (main.py with predict() function)                   │
│  - Runs the deployment command                                          │
│  - Reports the endpoint URL                                             │
└─────────────────────────────────────────────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────────┐
│  Phase 3: RUNNER CREATION                                               │
│  ────────────────────────                                               │
│  Factory creates the appropriate Runner for the strategy:               │
│  - LocalRunner: imports and calls Python functions                      │
│  - ModalRunner: calls Modal remote functions                            │
│  - DockerRunner: makes HTTP requests to container                       │
└─────────────────────────────────────────────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────────┐
│  Phase 4: SOFTWARE WRAPPER                                              │
│  ─────────────────────────                                              │
│  DeployedSoftware wraps the runner with unified interface:              │
│  - Normalizes all responses to {"status": "...", "output": ...}         │
│  - Provides run(), stop(), logs(), is_healthy()                         │
│  - Hides all infrastructure complexity from users                       │
└─────────────────────────────────────────────────────────────────────────┘

# Success
{
    "status": "success",
    "output": {...}  # Your function's return value
}

# Error
{
    "status": "error",
    "error": "Error message here"
}