Metadata-Version: 2.4
Name: symphony-code
Version: 0.0.3
Summary: Symphony coding agent: workspace tools, JSONL sessions, and a Textual TUI on top of symphony-harness (import as coding_agent; run as `symphony`)
Author: Sarthak Chauhan
Author-email: Sarthak Chauhan <sarthakchauhann@gmail.com>
License-Expression: MIT
License-File: LICENSE
Requires-Dist: symphony-core
Requires-Dist: symphony-harness
Requires-Dist: pillow>=12.3.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: certifi>=2024.2.2
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: textual>=8.2.8
Requires-Dist: textual-image>=0.12.0
Requires-Dist: termaid>=0.9.0
Requires-Dist: sounddevice>=0.5.1
Requires-Dist: langfuse>=3.0.0 ; extra == 'langfuse'
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/Sarthakischauhan/symphony
Project-URL: Documentation, https://github.com/Sarthakischauhan/symphony/blob/main/docs/packages/symphony-code.md
Project-URL: Source, https://github.com/Sarthakischauhan/symphony/tree/main/coding_agent
Provides-Extra: langfuse
Description-Content-Type: text/markdown

# symphony-code

Run an AI coding agent in your terminal, or import the coding-agent API from the Symphony workspace. Package import name: `coding_agent`.

**Availability:** version 0.0.1 is on PyPI.

```sh
python -m pip install symphony-code
symphony --workspace /path/to/project
```

To run the current `main` branch instead of the published release, clone the repository, run `uv sync`, then `uv run --package symphony-code symphony --workspace /path/to/project`.

`symphony`, `symphony-code`, and `coding-agent-tui` are aliases for the same terminal application. Configure a provider on first launch, or set credentials beforehand. See the [installation guide](../docs/getting-started/installation.md) and [quickstart](../docs/getting-started/quickstart.md).

## Use the library

From the repository workspace:

```python
from core_ai import build_default_registry, default_model_id
from coding_agent import CodingAgent

registry = build_default_registry()
agent = CodingAgent(
    registry=registry,
    model_id=default_model_id(registry),
    workspace=".")
result = await agent.run("Fix the failing test")
print(result.output_text)
```

## Next steps

- [Terminal UI and controls](../docs/user-guide/tui.md)
- [Configuration and approvals](../docs/user-guide/configuration.md)
- [Tools and workspace access](../docs/user-guide/tools.md)
- [Sessions and resume](../docs/user-guide/sessions.md)
- [Package API guide](../docs/packages/symphony-code.md)

**Safety:** tools run with the current user's permissions; approval prompts do not sandbox commands or restrict paths. Read the [security policy](../SECURITY.md) before use.

### Browser interface

Run `symphony web --workspace /path/to/project` to launch Symphony Web. Installed
wheels include the React frontend; Node.js is not needed by end users. See the
[Web guide](../docs/developer-guide/web.md) for development and security details.
