{"id":48732490,"url":"https://github.com/getlark/runtimeuse","last_synced_at":"2026-04-19T23:04:48.535Z","repository":{"id":345370633,"uuid":"1179203173","full_name":"getlark/runtimeuse","owner":"getlark","description":"Run AI agents inside sandboxes over WebSockets","archived":false,"fork":false,"pushed_at":"2026-04-12T00:45:43.000Z","size":455,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T02:13:26.995Z","etag":null,"topics":["agents","agents-sdk","ai-agents","claude-code","mcp","openai","websockets"],"latest_commit_sha":null,"homepage":"https://docs.runtimeuse.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getlark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-11T19:46:01.000Z","updated_at":"2026-04-12T00:41:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/getlark/runtimeuse","commit_stats":null,"previous_names":["getlark/runtimeuse"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/getlark/runtimeuse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlark%2Fruntimeuse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlark%2Fruntimeuse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlark%2Fruntimeuse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlark%2Fruntimeuse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getlark","download_url":"https://codeload.github.com/getlark/runtimeuse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlark%2Fruntimeuse/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32025786,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","agents-sdk","ai-agents","claude-code","mcp","openai","websockets"],"created_at":"2026-04-12T02:09:17.771Z","updated_at":"2026-04-19T23:04:48.521Z","avatar_url":"https://github.com/getlark.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# runtimeuse\n\n[![Twitter Follow](https://img.shields.io/twitter/follow/getlark)](https://twitter.com/getlark)\n\nRun AI agents inside sandboxes and communicate with them over WebSocket.\n\n| Package                                                    | Language   | Role                                       | Install                         |\n| ---------------------------------------------------------- | ---------- | ------------------------------------------ | ------------------------------- |\n| [`runtimeuse`](./packages/runtimeuse)                      | TypeScript | Agent runtime (runs inside the sandbox)    | `npm install runtimeuse`        |\n| [`runtimeuse-client`](./packages/runtimeuse-client-python) | Python     | Client (connects from outside the sandbox) | `pip install runtimeuse-client` |\n\n## Quick Start\n\n### 1. Start the runtime (inside a sandbox)\n\n```bash\nexport OPENAI_API_KEY=your_openai_api_key\nnpx -y runtimeuse@latest\n```\n\nThis starts a WebSocket server on port 8080 using the default OpenAI handler. For fuller Claude-based sandbox examples, see [`examples/`](./examples).\n\n### 2. Connect from Python\n\n```python\nimport asyncio\nfrom runtimeuse_client import (\n    QueryOptions,\n    RuntimeEnvironmentDownloadableInterface,\n    RuntimeUseClient,\n    TextResult,\n)\n\nWORKDIR = \"/runtimeuse\"\n\nasync def main():\n    client = RuntimeUseClient(ws_url=\"ws://localhost:8080\")\n\n    result = await client.query(\n        prompt=\"Summarize the contents of the codex repository.\",\n        options=QueryOptions(\n            system_prompt=\"You are a helpful assistant.\",\n            model=\"gpt-5.4\",\n            pre_agent_downloadables=[\n                RuntimeEnvironmentDownloadableInterface(\n                    download_url=\"https://github.com/openai/codex/archive/refs/heads/main.zip\",\n                    working_dir=WORKDIR,\n                )\n            ],\n        ),\n    )\n\n    assert isinstance(result.data, TextResult)\n    print(result.data.text)\n\nasyncio.run(main())\n```\n\nSee the [runtime README](./packages/runtimeuse/README.md) and [client README](./packages/runtimeuse-client-python/README.md) for full API docs.\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](./CONTRIBUTING.md) for local setup, package-specific development commands, and the recommended checks to run before opening a PR.\n\n## License\n\n[FSL-1.1-ALv2](./LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetlark%2Fruntimeuse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetlark%2Fruntimeuse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetlark%2Fruntimeuse/lists"}