Metadata-Version: 2.5
Name: envarlive
Version: 0.1.0a8
Summary: Live voice, avatars and consented visual inputs for user-operated agents
Project-URL: Repository, https://github.com/EnvarAI/EnvarLive
Project-URL: Documentation, https://github.com/EnvarAI/EnvarLive/tree/main/docs
Project-URL: Issues, https://github.com/EnvarAI/EnvarLive/issues
Author: EnvarAI contributors
License-Expression: MIT
License-File: LICENSE
License-File: THIRD_PARTY_NOTICES.md
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: httpx<1,>=0.28
Requires-Dist: mcp==1.28.1
Requires-Dist: pydantic<3,>=2.11
Requires-Dist: starlette<2,>=1.3
Requires-Dist: tomli-w<2,>=1.2
Requires-Dist: uvicorn<1,>=0.31
Requires-Dist: websockets<17,>=15
Provides-Extra: test
Requires-Dist: build>=1.2; extra == 'test'
Requires-Dist: pytest-asyncio>=0.25; extra == 'test'
Requires-Dist: pytest>=8; extra == 'test'
Requires-Dist: respx>=0.22; extra == 'test'
Requires-Dist: ruff>=0.12; extra == 'test'
Description-Content-Type: text/markdown

# EnvarLive

An operator-hosted Live interface for an existing Agent: text, voice, avatars,
explicitly supplied images, native task progress, tool approvals and protected files.
Envar opens the interface only for the Agent owner. Model, avatar and wallet secrets
stay in the operator's environment.

Requires Python 3.11+ and Node.js 24+ on Linux/macOS. Select an existing reviewed
Hermes installation or an authenticated OpenClaw Gateway; no model/provider fallback
or automatic package installer is embedded in the SDK.

```sh
uv tool install 'envarlive==0.1.0a8'
envarlive init --runtime hermes --directory ./agent-live
envarlive doctor --config ./agent-live/live.toml
envarlive serve --config ./agent-live/live.toml
```

The published Python wheel includes viewer assets; no npm or build step is needed
after installation. `doctor` checks Node/SQLite without inference. This is an alpha
release. CI candidates, production-site checks and physical microphone/avatar
acceptance have separate evidence; installing the package does not establish a
production SLA for the operator's runtime or HTTPS origin.

Review the profile and use a dedicated HTTPS origin. On your Envar Agent, add its
private Live `/mcp` entry, apply the exact ownership challenge with `envarlive connect`,
restart and verify. The stdio host plugin forwards to that same service and does not
start another Agent.

Stable request IDs and private journals prevent restart from creating another task.
Uncertain operations retain their native identity and block replacement work until
inspected. Image bytes and provider/service tokens are excluded from SDK journals.
Avatar starts have a persistent rolling limit; normal close/timeout share one stop.

The executor must have a separate OS/container identity from an EnvarPay signer and
must never receive wallet key mounts. OpenClaw's current connector advertises final
text/run states; remote files, tool approval and cancellation are not advertised.
Task escrow belongs to EnvarPay and remains a separate testnet-only feature.

For payments, install [EnvarPay](https://pypi.org/project/envarpay/) as a separate
Python wallet/MCP service. JavaScript and TypeScript Agents use
`@envarai/envarpay` to call that service; the client holds no signing key. Native
hosts connect through MCP, and other languages can use the documented MCP HTTP
interface. EnvarLive supplies the interactive interface; it never signs payments.

[Source and full setup](https://github.com/EnvarAI/EnvarLive) ·
[Operator deployment and recovery](https://github.com/EnvarAI/EnvarLive/blob/main/docs/operations.md)
