Metadata-Version: 2.5
Name: vis-agent
Version: 0.2.50.dev7731
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.12
Requires-Dist: harbor==0.24.0
Requires-Dist: jsonschema<5,>=4.23
Requires-Dist: litellm==1.103.1
Requires-Dist: packaging>=24
Requires-Dist: pydantic<3,>=2.13.5
Requires-Dist: referencing>=0.28.4
Provides-Extra: docs
Requires-Dist: pdoc==16.0.0; extra == 'docs'
Description-Content-Type: text/markdown

# vis-agent

Python SDK for Vis agent sessions and extensions.

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

You need Python 3.12+ on Linux or macOS and a configured model provider. You do not
have to install Vis first. A local run uses the installed `vis-agent` only when it is
the same release as the SDK. Otherwise the SDK downloads only that release's engine into
`~/.vis/sdk` and checks it against the release checksums. Set `VIS_NO_AUTO_INSTALL=1` to
turn this off. To download the engine ahead of time, for example in a container image, run
`python -c "from blockether.vis.engine import install; print(install())"`.

## 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 a private Vis process with a temporary session database and removes both
when the block ends. Tasks can incur provider charges and can change project files. To
choose the executable or share one process between agents, 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.
- [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.
- [Decision models](https://vis.blockether.com/decision-models.html) — download
  Laya or GLiNER2.5, train both heads offline, publish FP32 and select a version.
- [Documentation](https://vis.blockether.com) — browse all guides and reference pages.
