Metadata-Version: 2.4
Name: master-agents-client
Version: 1.0.0
Summary: Thin client for the Master Agents service. Talks to a hosted server; bundles no orchestration logic, prompts, or agent specs.
Author: Thang Nguyen
License: MIT
Project-URL: Homepage, https://agents.sim-os.ai
Project-URL: Issues, https://github.com/nguyenhoangthangbt/master-agents-client/issues
Keywords: agents,llm,ai,client,cli
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7
Requires-Dist: prompt_toolkit>=3.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: python-docx>=1.1
Requires-Dist: python-pptx>=0.6.23
Requires-Dist: pypdf<7,>=4.0
Requires-Dist: openpyxl>=3.1
Requires-Dist: xhtml2pdf>=0.2.16
Requires-Dist: matplotlib>=3.8
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: jsonpath-ng>=1.5
Requires-Dist: Pillow>=10
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Dynamic: license-file

# Master Agents — Client

Thin client for the Master Agents service.

This package gives you a CLI (`agents`) to chat with hosted agents, run one-shot
prompts, and let those agents execute file/git/bash tools **on your machine**
under explicit path allowlists.

The client ships **no orchestration logic, no prompts, and no agent specs** —
those live on the service. You point this client at a service URL, log in,
and start a conversation.

## Install

```bash
pip install master-agents-client
```

Requires Python 3.11+.

## First chat (60 seconds)

```bash
# 1. Save server URL + token (pasted at the prompt or via --token).
agents remote login --server https://agents-api.sim-os.ai

# 2. Start an interactive session.
agents remote chat
```

Inside the chat, type `/help` for the full command reference.

## One-shot mode

```bash
agents remote run "summarise the README in ./my-project"
```

The chosen master agent decides which tools to call. File/edit/bash tools run
on your machine inside the paths you allowlisted at login (see
`--writable-paths`).

## What runs where

| | Where it runs |
|---|---|
| Chat REPL, slash commands | Your machine (this client) |
| File reads / writes / edits, bash, git | Your machine (this client) |
| Agent reasoning, model calls, retrieval | The service |

The client never uploads your source files to the service — only the tool
output text the agent asked for.

## Configuration

Server URL + token live in `~/.master_agents/remote.yaml` after `login`.

Override per-call with `--config <path>`. Env-var override:
`MASTER_AGENTS_REMOTE_CONFIG=/path/to/remote.yaml`.

## More

See [`USER_GUIDE.md`](USER_GUIDE.md) for slash commands, troubleshooting, and
environment variables.

## License

MIT.
