Metadata-Version: 2.4
Name: miosa-adk
Version: 1.0.0
Summary: Official Python Agent Development Kit for MIOSA — build LLM agents that natively use MIOSA sandboxes, desktop computers, and deployments with the tool-call loop pre-wired.
Project-URL: Homepage, https://miosa.ai
Project-URL: Documentation, https://miosa.ai/docs/adk
Project-URL: Repository, https://github.com/Miosa-osa/adk
Project-URL: Issues, https://github.com/Miosa-osa/adk/issues
Project-URL: Changelog, https://github.com/Miosa-osa/adk/blob/main/CHANGELOG.md
Project-URL: Source, https://github.com/Miosa-osa/adk
Author-email: MIOSA <hello@miosa.ai>
License-Expression: MIT
Keywords: adk,agents,ai-agents,ai-app-builder,anthropic,claude,computer-use,firecracker,groq,llm,lovable,mcp,miosa,openai,sandbox,tool-calling
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx<1.0.0,>=0.25.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: miosa
Requires-Dist: miosa>=1.0.0; extra == 'miosa'
Description-Content-Type: text/markdown

# miosa-adk Python

Python Agent Development Kit for MIOSA sandboxes.

Use this when you want an LLM agent to create a sandbox, write files, run
commands, start a dev server, and return a preview URL.

## Install

```bash
pip install "miosa-adk @ git+https://github.com/Miosa-osa/adk.git#subdirectory=python"
```

If you want the built-in MIOSA sandbox/computer tools, install the MIOSA Python
SDK as well. Until the MIOSA Python SDK is published to PyPI, use your local SDK
checkout or install it through the package source your team uses internally.

Once both packages are published to PyPI, the intended install is:

```bash
pip install miosa miosa-adk
```

## Website Builder Example

```python
import os
from miosa_adk import Agent, groq_provider, sandbox_builder_system_prompt

agent = Agent(
    provider=groq_provider(
        api_key=os.environ["GROQ_API_KEY"],
        model="moonshotai/kimi-k2-instruct-0905",
    ),
    miosa_api_key=os.environ["MIOSA_API_KEY"],
    miosa_tool_options={"allow_destroy": False},
)

result = agent.run(
    "Build a one-page site for a boutique gym. Run it on port 3000 and return the preview URL.",
    system=sandbox_builder_system_prompt("website"),
    max_iterations=12,
)

print(result.final_text)
```

## Provider Factories

- `openai_provider`
- `groq_provider`
- `deepseek_provider`
- `openrouter_provider`
- `together_provider`
- `fireworks_provider`
- `mistral_provider`
- `cerebras_provider`
- `perplexity_provider`
- `xai_provider`
- `ollama_provider`
- `lm_studio_provider`
- `openai_compatible_provider`

## Builder Presets

```python
sandbox_builder_system_prompt("website")
sandbox_builder_system_prompt("app")
sandbox_builder_system_prompt("artifact")
sandbox_builder_system_prompt("slide_deck")
```

## Examples

See `examples/` for website, app, artifact, and slide deck builders.
