Skip to main content

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

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:

pip install miosa miosa-adk

Website Builder Example

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

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.

Metadata

Release files for miosa-adk 1.0.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 miosa-adk 1.0.0
File Size Uploaded Provenance
miosa_adk-1.0.0.tar.gz 35.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for miosa-adk 1.0.0
File Interpreter ABI Platform
miosa_adk-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 46.2 kB

Release files / miosa_adk-1.0.0.tar.gz

Download URL miosa_adk-1.0.0.tar.gz
Size 35.7 kB
Tags Source
SHA-256 checksum
How to use checksums
b70b0d03f8ac9ec8d41d30f928018bef29d1525f1b7c5d5d9b252d1a92e34782
BLAKE2b-256 checksum
How to use checksums
3b53d969e8035f639d691e166a84ece81dab4ca9b8edbef1e31b7b52d2e6da90
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Release files / miosa_adk-1.0.0-py3-none-any.whl

Download URL miosa_adk-1.0.0-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
074cb1fd1b21f961f5c0c48f965272a7e431c092694c056bfdd2b51c4481b297
BLAKE2b-256 checksum
How to use checksums
696b0b742729376c96a5a066b75744ffb02b34d3163d28fb266deab8d6789227
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Security for miosa-adk 1.0.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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

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