modus-sdk 0.2.0__tar.gz

modus_sdk-0.2.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+
+# Environment variables
+.env
+.env.*
+
+# Test / lint artifacts
+reports/
+
+# hatch-vcs: auto-generated at build time, never committed
+modus/_version.py

modus_sdk-0.2.0/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+**Current release:** [`0.2.0`](https://pypi.org/project/modus-sdk/0.2.0/).
+
+
+## [0.2.0] — 2026-07-20
+
+### Added
+
+- **`modus.Modus` / `AsyncModus`** — read and invoke: scopes, workflows, context, connections, Modus assistant chat, runs, suggestions.
+- **`modus.management.ModusManagement` / `AsyncModusManagement`** — configure: CRUD, deploy, context creators, usage, org admin, scope evaluations.
+- Canonical **`client.scopes` / `client.workflows`** (and management equivalents) against `/api/v1/scopes` and `/api/v1/workflows`.
+- **`client.modus`** — org-wide Modus assistant (`chat`, `chat_stream`, `get_context`, `conversations`).
+- **`client.suggestions`** — list approved suggested questions; record impression/click/dismiss events.
+- **`client.workflows.runs.active()` / `active_by_session(...)`** — list or look up active conversation runs.
+- **`mgmt.scopes.evaluations(scope_id)`** — evaluation config, manual trigger, run history.
+- Bounded conversation windows via optional `message_limit` / `before_message_index` on `conversations(...).get()`.
+- MCP **`get_context_data`** batch + ACL: `{ items: [{ itemId, field?, mode?, limit? }, …], sessionId? }` → `{ results: [...] }` (max 20; per-item partial failures).
+- Cursor pagination, retries on 429/5xx, SSE streaming chat.
+- Full public OpenAPI operation coverage (contract-tested).
+
+### Changed
+
+- Public surface uses **Scope** / **Workflow** vocabulary (types remain `Skill` / `Agent` where the API still uses those names).
+- Scope-run helper: `client.workflows.runs.create_scope(scope_id, body)` (not `create_skill`).
+
+### Removed
+
+- Legacy **`client.skills` / `client.agents`** accessors — use `scopes` / `workflows`.
+- Unimplemented context-creator stubs (`dimension` / `fact` / `metric` / `filter` create DTOs).
+
+## Prior (TestPyPI only)
+
+| Version | Notes |
+|---------|--------|
+| 0.1.0–0.1.7 | Internal / TestPyPI previews. Not published to production PyPI. Superseded by `0.2.0`. |
+
+## [Unreleased]
+

modus_sdk-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing
+
+Thank you for your interest in the Modus Python SDK.
+
+## Reporting Issues
+
+Please open a [GitHub issue](https://github.com/modus-data/modus-sdk-python/issues)
+for bug reports and feature requests. Include:
+
+- SDK version (`python -c "import modus; print(modus.__version__)"`)
+- Python version
+- A minimal reproducible example
+
+For security vulnerabilities, do not open a public GitHub issue — contact the
+Modus team through your existing support channel.
+
+## Questions & Support
+
+For usage questions and general support, use the
+[Modus community forum](https://modus.com) or email **support@modus.com**.
+
+## Pull Requests
+
+This repository is a **release mirror** of the Python SDK package. Pull requests
+are not accepted here.
+
+Development happens in the Modus monorepo. If you have a proposed fix or feature,
+open an issue in this repository and the team will route it internally.
+
+## Running tests (from a source checkout)
+
+If you have cloned this mirror with the `tests/` directory:
+
+```bash
+cd modus-sdk   # repository root after mirror split
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest tests/ -m "not integration"
+```
+
+Optional live API smoke tests (require a valid token and reachable API):
+
+```bash
+export MODUS_API_KEY=modus_xxx
+pytest tests/integration/ -m integration
+```

modus_sdk-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Modus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

modus_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: modus-sdk
+Version: 0.2.0
+Summary: Official Python client for Modus — your organization's context layer for AI
+License: MIT
+License-File: LICENSE
+Keywords: ai,data,modus,sdk
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0.0,>=0.27.0
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Provides-Extra: dev
+Requires-Dist: datamodel-code-generator<0.61,>=0.60.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=9.0.3; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.15; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/modus-data/modus-sdk-python/main/assets/modus-logo.png"
+    alt="Modus"
+    width="280"
+  />
+</p>
+
+# Modus Python SDK
+
+[![PyPI](https://img.shields.io/pypi/v/modus-sdk)](https://pypi.org/project/modus-sdk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/modus-sdk)](https://pypi.org/project/modus-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Official Python client for Modus — your organization's context layer for AI.
+
+## What is Modus?
+
+Modus is your organization's context layer: it connects assistants to curated knowledge about your data, systems, and workflows so answers use org-specific context instead of generic guesses.
+
+- **Modus** — your org-wide assistant (same capability as the Modus home page)
+- **Scopes** — published assistants you chat with, each with its own context and tools
+- **Workflows** — automations that run on a schedule or trigger
+- **Context items** — curated knowledge Modus composes at runtime when answering
+
+## Two clients in one package
+
+**`modus.Modus()`** is what most people need. Use it to chat with Modus, run scopes, browse context, and inspect workflow runs — the same things you do in the Modus app day to day.
+
+**`modus.management.ModusManagement()`** is for org setup: create, update, and deploy scopes, workflows, and context — the CRUD operations you would use in the Modus UI as an admin.
+
+If you are getting started, use `Modus()` only. Reach for `ModusManagement()` when you are automating configuration.
+
+Async variants: `AsyncModus` and `AsyncModusManagement`.
+
+## Installation
+
+```bash
+pip install modus-sdk
+```
+
+Requires Python 3.10+.
+
+## Getting started
+
+```python
+import modus
+
+# Reads MODUS_API_KEY env var, or pass api_key= explicitly
+client = modus.Modus()
+
+for scope in client.scopes.list():
+    print(scope.name, scope.status)
+
+scope = client.scopes.get("revenue-analysis")
+print(scope.name, scope.description)
+
+for item in client.context.items.list():
+    print(item.uid, item.context_type, modus.context_item_label(item))
+```
+
+## Authentication
+
+Create an API token in the Modus app (**Settings → API Tokens** on your Modus home page). Prefer an environment variable over hardcoding keys in source:
+
+```bash
+export MODUS_API_KEY=modus_xxx
+```
+
+```python
+client = modus.Modus(api_key="modus_xxx")
+```
+
+## Using Modus
+
+### Modus vs scopes
+
+| Surface | SDK | Use when |
+|---------|-----|----------|
+| **Modus** (org-wide) | `client.modus.*` | Full-environment assistant — same as the Modus home page |
+| **Scope** | `client.scopes.*` | A specific published scope and its configured context/tools |
+
+Use `client.modus.chat()` for native Modus — not `scopes.chat(0)` or any other scope id shortcut.
+
+### Org-wide Modus assistant
+
+```python
+MODEL = "claude-sonnet-5"
+
+result = client.modus.chat("What were our top revenue drivers last quarter?", model=MODEL)
+print(result.content, result.thread_id)
+
+follow_up = client.modus.chat(
+    "Break that down by region.",
+    model=MODEL,
+    thread_id=result.thread_id,
+)
+print(follow_up.content)
+
+with client.modus.chat_stream("Summarize this week", model=MODEL) as stream:
+    for chunk in stream.text_stream:
+        print(chunk, end="")
+
+ctx = client.modus.get_context("What tables describe customer churn?", limit=10)
+print(ctx.original_count, ctx.session_id)
+
+for row in client.modus.conversations.list(kind="modus", page_size=10):
+    print(row.thread_id, row.first_message)
+```
+
+### Scopes
+
+```python
+MODEL = "claude-sonnet-5"
+
+result = client.scopes.chat(scope_id, "Hello", model=MODEL)
+print(result.content, result.thread_id)
+
+with client.scopes.chat_stream(scope_id, "Hi", model=MODEL) as stream:
+    for chunk in stream.text_stream:
+        print(chunk, end="")
+```
+
+### Context
+
+```python
+for item in client.context.items.list():
+    print(item.uid, modus.context_item_label(item))
+```
+
+### Workflows
+
+```python
+workflow = client.workflows.get(workflow_id)
+for run in client.workflows.runs.list(workflow_id, page_size=20):
+    print(run.id, run.status)
+```
+
+Workflow chat is not on the public PAT surface. Use `client.modus.chat()` for org-wide conversation or `client.scopes.chat()` for a published scope.
+
+## Managing your org
+
+```python
+from modus.management import ModusManagement
+
+mgmt = ModusManagement()  # reads MODUS_API_KEY
+scope = mgmt.scopes.create(name="Analyst", model="claude-sonnet-5")
+mgmt.scopes.deploy(scope.id)
+```
+
+Requires a token with write access to scopes and workflows (same as the Modus UI).
+
+## Pagination
+
+List endpoints return a `Page[T]`. Iterate the current page, or use `.auto_paging_iter()` for all pages:
+
+```python
+for scope in client.scopes.list().auto_paging_iter():
+    print(scope.name)
+```
+
+`client.modus.conversations.list()` accepts `kind="modus"`, `"skills"`, or `"all"` (default).
+
+## Async
+
+```python
+import asyncio
+import modus
+
+async def main():
+    async with modus.AsyncModus() as client:
+        result = await client.modus.chat("Hello", model="claude-sonnet-5")
+        print(result.content)
+
+        async for scope in client.scopes.list().auto_paging_iter():
+            print(scope.name)
+
+asyncio.run(main())
+```
+
+## Error handling
+
+```python
+try:
+    scope = client.scopes.get(999)
+except modus.NotFoundError:
+    print("Scope not found")
+except modus.AuthenticationError:
+    print("Check your MODUS_API_KEY")
+except modus.RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except modus.ModusError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Examples
+
+Runnable scripts ship with the package:
+
+- `examples/scripts/quickstart.py` — list scopes and context (`Modus`)
+- `examples/scripts/modus_chat.py` — buffered and streaming Modus chat, context compose, conversations
+- `examples/scripts/chat.py` — buffered scope chat with thread follow-up
+- `examples/scripts/manage_skill.py` — create and deploy a scope (`ModusManagement`, `--write` optional)
+
+Optional Streamlit demo: `examples/apps/modus_skill_chat/` (streaming vs buffered scope chat side by side).

modus_sdk-0.2.0/README.md

@@ -0,0 +1,205 @@
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/modus-data/modus-sdk-python/main/assets/modus-logo.png"
+    alt="Modus"
+    width="280"
+  />
+</p>
+
+# Modus Python SDK
+
+[![PyPI](https://img.shields.io/pypi/v/modus-sdk)](https://pypi.org/project/modus-sdk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/modus-sdk)](https://pypi.org/project/modus-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Official Python client for Modus — your organization's context layer for AI.
+
+## What is Modus?
+
+Modus is your organization's context layer: it connects assistants to curated knowledge about your data, systems, and workflows so answers use org-specific context instead of generic guesses.
+
+- **Modus** — your org-wide assistant (same capability as the Modus home page)
+- **Scopes** — published assistants you chat with, each with its own context and tools
+- **Workflows** — automations that run on a schedule or trigger
+- **Context items** — curated knowledge Modus composes at runtime when answering
+
+## Two clients in one package
+
+**`modus.Modus()`** is what most people need. Use it to chat with Modus, run scopes, browse context, and inspect workflow runs — the same things you do in the Modus app day to day.
+
+**`modus.management.ModusManagement()`** is for org setup: create, update, and deploy scopes, workflows, and context — the CRUD operations you would use in the Modus UI as an admin.
+
+If you are getting started, use `Modus()` only. Reach for `ModusManagement()` when you are automating configuration.
+
+Async variants: `AsyncModus` and `AsyncModusManagement`.
+
+## Installation
+
+```bash
+pip install modus-sdk
+```
+
+Requires Python 3.10+.
+
+## Getting started
+
+```python
+import modus
+
+# Reads MODUS_API_KEY env var, or pass api_key= explicitly
+client = modus.Modus()
+
+for scope in client.scopes.list():
+    print(scope.name, scope.status)
+
+scope = client.scopes.get("revenue-analysis")
+print(scope.name, scope.description)
+
+for item in client.context.items.list():
+    print(item.uid, item.context_type, modus.context_item_label(item))
+```
+
+## Authentication
+
+Create an API token in the Modus app (**Settings → API Tokens** on your Modus home page). Prefer an environment variable over hardcoding keys in source:
+
+```bash
+export MODUS_API_KEY=modus_xxx
+```
+
+```python
+client = modus.Modus(api_key="modus_xxx")
+```
+
+## Using Modus
+
+### Modus vs scopes
+
+| Surface | SDK | Use when |
+|---------|-----|----------|
+| **Modus** (org-wide) | `client.modus.*` | Full-environment assistant — same as the Modus home page |
+| **Scope** | `client.scopes.*` | A specific published scope and its configured context/tools |
+
+Use `client.modus.chat()` for native Modus — not `scopes.chat(0)` or any other scope id shortcut.
+
+### Org-wide Modus assistant
+
+```python
+MODEL = "claude-sonnet-5"
+
+result = client.modus.chat("What were our top revenue drivers last quarter?", model=MODEL)
+print(result.content, result.thread_id)
+
+follow_up = client.modus.chat(
+    "Break that down by region.",
+    model=MODEL,
+    thread_id=result.thread_id,
+)
+print(follow_up.content)
+
+with client.modus.chat_stream("Summarize this week", model=MODEL) as stream:
+    for chunk in stream.text_stream:
+        print(chunk, end="")
+
+ctx = client.modus.get_context("What tables describe customer churn?", limit=10)
+print(ctx.original_count, ctx.session_id)
+
+for row in client.modus.conversations.list(kind="modus", page_size=10):
+    print(row.thread_id, row.first_message)
+```
+
+### Scopes
+
+```python
+MODEL = "claude-sonnet-5"
+
+result = client.scopes.chat(scope_id, "Hello", model=MODEL)
+print(result.content, result.thread_id)
+
+with client.scopes.chat_stream(scope_id, "Hi", model=MODEL) as stream:
+    for chunk in stream.text_stream:
+        print(chunk, end="")
+```
+
+### Context
+
+```python
+for item in client.context.items.list():
+    print(item.uid, modus.context_item_label(item))
+```
+
+### Workflows
+
+```python
+workflow = client.workflows.get(workflow_id)
+for run in client.workflows.runs.list(workflow_id, page_size=20):
+    print(run.id, run.status)
+```
+
+Workflow chat is not on the public PAT surface. Use `client.modus.chat()` for org-wide conversation or `client.scopes.chat()` for a published scope.
+
+## Managing your org
+
+```python
+from modus.management import ModusManagement
+
+mgmt = ModusManagement()  # reads MODUS_API_KEY
+scope = mgmt.scopes.create(name="Analyst", model="claude-sonnet-5")
+mgmt.scopes.deploy(scope.id)
+```
+
+Requires a token with write access to scopes and workflows (same as the Modus UI).
+
+## Pagination
+
+List endpoints return a `Page[T]`. Iterate the current page, or use `.auto_paging_iter()` for all pages:
+
+```python
+for scope in client.scopes.list().auto_paging_iter():
+    print(scope.name)
+```
+
+`client.modus.conversations.list()` accepts `kind="modus"`, `"skills"`, or `"all"` (default).
+
+## Async
+
+```python
+import asyncio
+import modus
+
+async def main():
+    async with modus.AsyncModus() as client:
+        result = await client.modus.chat("Hello", model="claude-sonnet-5")
+        print(result.content)
+
+        async for scope in client.scopes.list().auto_paging_iter():
+            print(scope.name)
+
+asyncio.run(main())
+```
+
+## Error handling
+
+```python
+try:
+    scope = client.scopes.get(999)
+except modus.NotFoundError:
+    print("Scope not found")
+except modus.AuthenticationError:
+    print("Check your MODUS_API_KEY")
+except modus.RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except modus.ModusError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Examples
+
+Runnable scripts ship with the package:
+
+- `examples/scripts/quickstart.py` — list scopes and context (`Modus`)
+- `examples/scripts/modus_chat.py` — buffered and streaming Modus chat, context compose, conversations
+- `examples/scripts/chat.py` — buffered scope chat with thread follow-up
+- `examples/scripts/manage_skill.py` — create and deploy a scope (`ModusManagement`, `--write` optional)
+
+Optional Streamlit demo: `examples/apps/modus_skill_chat/` (streaming vs buffered scope chat side by side).

modus_sdk-0.2.0/assets/modus-logo.svg

@@ -0,0 +1,13 @@
+<svg width="285" height="61" viewBox="0 0 285 61" fill="none" color="#3262FF" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_286_163)">
+<path d="M55.2983 42.8834C54.751 42.8368 54.2105 42.808 53.6606 42.7975C43.9042 42.4159 33.1793 49.1184 31.4067 59.7994C31.3068 60.3796 31.2328 60.9615 31.186 61.5553H24.4956C24.4488 60.9615 24.3748 60.3796 24.2749 59.7994C22.5023 49.1183 11.7775 42.4158 2.021 42.7975C1.4711 42.808 0.930604 42.8368 0.383301 42.8834V33.9069C1.12817 33.9537 1.85781 34.0252 2.59521 34.1207C15.2942 35.53 26.8692 45.713 27.8403 58.0631C28.8114 45.7131 40.3875 35.5301 53.0864 34.1207C53.8238 34.0252 54.5535 33.9537 55.2983 33.9069V42.8834Z" fill="currentColor"/>
+<path d="M55.301 18.2284C54.7538 18.2751 54.2131 18.3038 53.6633 18.3143C43.9068 18.696 33.182 11.9935 31.4094 1.31238C31.3095 0.732203 31.2355 0.15036 31.1887 -0.443481H24.4983C24.4515 0.150316 24.3775 0.732243 24.2776 1.31238C22.505 11.9934 11.7802 18.6959 2.02368 18.3143C1.47379 18.3038 0.933275 18.2751 0.385986 18.2284V27.205C1.13082 27.1581 1.86052 27.0867 2.5979 26.9911C15.2955 25.5819 26.8698 15.4008 27.843 3.05261C28.8162 15.4009 40.3914 25.582 53.0891 26.9911C53.8264 27.0866 54.5562 27.1581 55.301 27.205V18.2284Z" fill="currentColor"/>
+<path d="M27.8416 15.1049C27.8416 15.1049 29.1317 23.1704 32.1291 26.1678C35.1265 29.1651 43.192 30.4553 43.192 30.4553C43.192 30.4553 35.1265 31.7455 32.1291 34.7428C29.1317 37.7402 27.8416 45.8057 27.8416 45.8057C27.8416 45.8057 26.5514 37.7402 23.554 34.7428C20.5567 31.7455 12.4911 30.4553 12.4911 30.4553C12.4911 30.4553 20.5567 29.1651 23.554 26.1678C26.5514 23.1704 27.8416 15.1049 27.8416 15.1049Z" fill="currentColor"/>
+<path d="M69.9199 53.5372V18.4094H76.2005V22.7183C78.2454 19.0667 81.4587 17.387 85.7675 17.387C90.5876 17.387 94.1661 19.724 95.8458 23.6677C98.1097 19.4319 101.761 17.387 106.362 17.387C114.469 17.387 118.924 22.2801 118.924 31.0438V53.5372H111.913V31.4089C111.913 26.5159 109.576 23.8137 105.121 23.8137C100.958 23.8137 97.9637 27.0271 97.9637 31.628V53.5372H90.8797V31.4089C90.8797 26.5159 88.5427 23.8137 84.2339 23.8137C79.9981 23.8137 77.0039 27.0271 77.0039 31.628V53.5372H69.9199ZM145.316 54.5597C134.653 54.5597 127.204 47.1105 127.204 35.9368C127.204 24.8361 134.653 17.387 145.316 17.387C156.051 17.387 163.427 24.8361 163.427 35.9368C163.427 47.1105 156.051 54.5597 145.316 54.5597ZM134.507 35.9368C134.507 43.2399 138.889 48.133 145.316 48.133C151.815 48.133 156.124 43.2399 156.124 35.9368C156.124 28.7068 151.815 23.8137 145.316 23.8137C138.889 23.8137 134.507 28.7068 134.507 35.9368ZM186.865 54.5597C176.86 54.5597 169.995 47.1105 169.995 35.9368C169.995 24.8361 176.86 17.387 186.865 17.387C191.978 17.387 196.14 19.2858 198.331 22.7183V2.41571H205.342V53.5372H199.062V48.6442C196.725 52.3687 192.343 54.5597 186.865 54.5597ZM177.298 35.9368C177.298 43.2399 181.607 48.133 187.961 48.133C194.315 48.133 198.477 43.2399 198.477 35.9368C198.477 28.7068 194.315 23.8137 187.961 23.8137C181.607 23.8137 177.298 28.7068 177.298 35.9368ZM229.692 54.5597C221.148 54.5597 215.89 49.3014 215.89 39.5884V18.4094H222.974V38.9311C222.974 45.2117 225.895 48.133 231.007 48.133C236.338 48.133 239.771 44.3354 239.771 38.712V18.4094H246.855V53.5372H240.574V49.5205C238.237 52.953 234.22 54.5597 229.692 54.5597ZM270.113 54.5597C260.619 54.5597 254.996 50.7621 254.631 43.532H261.934C262.299 47.0375 265.147 48.7902 270.259 48.7902C274.933 48.7902 277.781 46.8184 277.781 43.605C277.781 40.9759 275.81 39.4423 272.158 39.0771L266.535 38.4929C259.962 37.8356 255.799 34.1841 255.799 28.3416C255.799 21.6228 261.422 17.387 270.04 17.387C278.804 17.387 284.208 21.0385 284.646 28.1956H277.562C277.343 24.8361 274.568 23.1564 269.967 23.1564C265.585 23.1564 262.81 24.9822 262.81 27.9765C262.81 30.5325 264.709 31.9201 268.799 32.4313L274.495 33.0886C281.141 33.8189 284.938 37.5435 284.938 43.3129C284.938 50.1778 279.169 54.5597 270.113 54.5597Z" fill="currentColor"/>
+</g>
+<defs>
+<clipPath id="clip0_286_163">
+<rect width="285" height="61" fill="currentColor"/>
+</clipPath>
+</defs>
+</svg>

modus_sdk-0.2.0/examples/apps/modus_skill_chat/.streamlit/config.toml

@@ -0,0 +1,9 @@
+[theme]
+primaryColor = "#3b82f6"
+backgroundColor = "#ffffff"
+secondaryBackgroundColor = "#f4f4f5"
+textColor = "#111111"
+font = "sans serif"
+
+[server]
+headless = true

modus_sdk-0.2.0/examples/apps/modus_skill_chat/README.md

@@ -0,0 +1,28 @@
+# Modus Skill Chat (Streamlit)
+
+Optional interactive demo: compare **streaming** (`client.skills.chat_stream()`) vs **buffered** (`client.skills.chat()`) skill chat side by side.
+
+## Setup
+
+Create an API token in the Modus app (**Settings → API Tokens** on your Modus home page), then export it in your shell (the app does **not** read `.env` files):
+
+```bash
+export MODUS_API_KEY=modus_xxx
+```
+
+## Run
+
+From this directory:
+
+```bash
+pip install modus-sdk streamlit
+streamlit run app.py
+```
+
+Open the URL Streamlit prints (default `http://localhost:8501`).
+
+## Usage
+
+- Pick an **active** skill and model in the sidebar.
+- Type a message at the bottom — it is sent to **both** panels in parallel.
+- Left: tokens arrive as they stream. Right: the full reply appears when complete.