Metadata-Version: 2.5
Name: vis-agent
Version: 0.2.29
Summary: The Vis Python SDK — author extensions and control local or remote engines.
Project-URL: Homepage, https://vis.blockether.com
Project-URL: Documentation, https://vis.blockether.com
Project-URL: Source, https://github.com/Blockether/vis
Project-URL: Issues, https://github.com/Blockether/vis/issues
Author: Blockether
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,automation,extension,human-in-the-loop,vis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: jsonschema<5,>=4.23
Requires-Dist: packaging>=24
Provides-Extra: decisions-gliner-training
Requires-Dist: gliner2[train]==2.0.0; extra == 'decisions-gliner-training'
Requires-Dist: onnx==1.23.0; extra == 'decisions-gliner-training'
Requires-Dist: onnxruntime==1.30.0; extra == 'decisions-gliner-training'
Requires-Dist: torch==2.14.0; extra == 'decisions-gliner-training'
Requires-Dist: transformers==4.57.6; extra == 'decisions-gliner-training'
Provides-Extra: decisions-training
Requires-Dist: laya==0.3.7; extra == 'decisions-training'
Requires-Dist: onnx==1.23.0; extra == 'decisions-training'
Requires-Dist: onnxruntime==1.30.0; extra == 'decisions-training'
Requires-Dist: torch==2.10.0; extra == 'decisions-training'
Requires-Dist: transformers==5.0.0; extra == 'decisions-training'
Provides-Extra: docs
Requires-Dist: pdoc==16.0.0; extra == 'docs'
Description-Content-Type: text/markdown

# vis-agent

Python SDK for Vis extensions and agent sessions.

```sh
pip install vis-agent
```

Requires Python 3.11+. Install the Vis executable and configure a provider
separately for local use. The execution-layer API below is unreleased: build
the SDK and engine from the same source revision.

## Run a local agent

```python
from blockether.vis.engine import Agent

with Agent(project=".") as agent:
    result = agent.run("Summarize this project without changing files.")
    print(result["status"])
```

The SDK starts an owned `vis-agent stdio` process, sets up a temporary session
database and cleans it up on close. This is a Python transport, not an
interactive CLI command or an MCP server. Tasks can incur provider charges and
access project files. For a chosen executable or multiple sessions on one
process, use `LocalEngine`; see the [stdio guide](https://vis.blockether.com/python-sdk.html#use-stdio-from-the-python-sdk).

- [Python SDK guide](https://vis.blockether.com/python-sdk.html) — run a local
  agent, continue a conversation or connect to a shared gateway. `Agent` is
  available in SDK `0.2.3` and newer.
- [Decision models](https://vis.blockether.com/decision-models.html) — download
  Laya or GLiNER2.5, train both heads offline, publish FP32 and select a version.
- [Python API reference](https://vis.blockether.com/python-sdk-api/) — browse
  classes, methods, signatures and types generated from the SDK source.
- [Extension guide](https://vis.blockether.com/extending.html) — add tools to Vis.
- [Documentation](https://vis.blockether.com) — browse all guides and reference pages.
