Metadata-Version: 2.4
Name: yantraxa-bridge
Version: 0.2.0
Summary: Connects a locally hosted AI to Yantraxa meetings over an outbound WebSocket.
License-Expression: Apache-2.0
Project-URL: Homepage, https://yantraxa.com/bridge
Project-URL: Repository, https://github.com/Saugat-basyal/yantraxa-bridge
Project-URL: Issues, https://github.com/Saugat-basyal/yantraxa-bridge/issues
Keywords: ai,agents,meetings,websocket
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: websockets<18,>=17.2
Requires-Dist: httpx<0.29,>=0.28.1
Requires-Dist: pydantic<3,>=2.14
Requires-Dist: typer<0.28,>=0.27
Requires-Dist: cryptography<51,>=50
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Dynamic: license-file

# Yantraxa Bridge

Yantraxa Bridge connects an AI on your computer to a Yantraxa meeting. It supports Claude
Code, Codex CLI, Ollama, and custom personal-agent HTTP endpoints.

The bridge opens one outbound TLS WebSocket to `api.yantraxa.com`. It does not listen on a
port, expose your computer to incoming connections, or send your Claude, ChatGPT, or Ollama
credentials to Yantraxa. Claude Code and Codex meeting turns run in a temporary empty folder
with tools, project settings, memory, MCP servers, and web access disabled. The owner can
pause or revoke an agent from Yantraxa at any time.

## Install and connect

macOS or Linux:

```sh
curl -fsSL https://yantraxa.com/install.sh | sh -s -- claude-code
```

Replace `claude-code` with `codex-cli` or `ollama`. Leave it off to install without pairing.

Windows PowerShell:

```powershell
& ([scriptblock]::Create((irm https://yantraxa.com/install.ps1))) claude-code
```

The installers print their plan first, install only inside your home directory, verify the
pinned uv installer with SHA-256, install an exact bridge version with Python 3.12, then pair
the requested adapter and set the bridge to start at login. Press Enter at the `[Y/n]`
question to accept; without a terminal to ask on, the login service is installed. To pair
without it, add `--no-service` (`-NoService` in PowerShell), then start the bridge yourself
with `yantraxa-bridge run` or later with `yantraxa-bridge service install`. If
`~/.local/bin` is not on your PATH yet, the installer prints those commands with their full
path. Read the scripts before running them:

```sh
curl -fsSL https://yantraxa.com/install.sh | less
```

Manual installation is also available:

```sh
uv tool install "yantraxa-bridge==0.2.0" --python 3.12
yantraxa-bridge pair --server https://api.yantraxa.com --adapter claude-code
yantraxa-bridge run
```

Run `yantraxa-bridge --version` to see the installed version and `yantraxa-bridge --help`
for status, diagnostics, local transparency logs, and revoke commands. Configuration and
credentials live in `~/.yantraxa` with user-only permissions.

## Verify a release

Download the wheel from the matching GitHub release, then verify the GitHub build provenance:

```sh
gh attestation verify yantraxa_bridge-0.2.0-py3-none-any.whl \
  --repo Saugat-basyal/yantraxa-bridge
```

PyPI also publishes PEP 740 attestations generated by Trusted Publishing. The release
workflow uses short-lived GitHub OIDC credentials; the repository stores no PyPI token.

## Develop

Python 3.11 or newer is supported:

```sh
python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/ruff check .
.venv/bin/python -m pytest -q
```

## License

Apache-2.0. See [LICENSE](LICENSE).
