Metadata-Version: 2.4
Name: cartesia-line
Version: 0.1.1
Summary: Cartesia Voice Agents SDK
Author-email: "Cartesia AI, Inc." <support@cartesia.ai>
License: Apache 2.0
Project-URL: Repository, https://github.com/cartesia-ai/line
Project-URL: Documentation, https://docs.cartesia.ai/line/
Project-URL: Homepage, https://cartesia.ai/agents
Keywords: voice,agents,ai,cartesia
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: loguru>=0.7.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: pydantic<3,>=2.0.0
Requires-Dist: uvicorn<1,>=0.35.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: ruff==0.12.8; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: google-genai<2,>=1.26.0; extra == "dev"
Provides-Extra: gemini
Requires-Dist: google-genai<2,>=1.26.0; python_version >= "3.9" and extra == "gemini"
Requires-Dist: aiohttp>=3.12.0; extra == "gemini"
Provides-Extra: openai
Requires-Dist: openai>=1.70.0; extra == "openai"
Dynamic: license-file

# Cartesia Line SDK

Build intelligent, low-latency voice agents with background reasoning.

**With Line you can,**
- **Create** your first voice agent from scratch, **deploy**, and **talk to it in under 5 minutes**.
- **Turn any existing chatbot** or text agent you've already built into a low-latency voice agent.
- **Spin up common use cases** for support or scheduling from **ready-made templates**.
- **Deploy production-ready systems** with auto-scaling, telephony integration, metrics, and call analytics.

**Why Line?**

- 🔗 **Event-driven design** to easily define multi-agent architectures with powerful background reasoning.
- ⚡ **State-of-the-art voice models** using Sonic TTS and Ink STT deliver the lowest latency voice experience.
- 📋 **Pre-built templates** for common use cases like customer support, sales agents, form filling, and more.
- 🔌 **Easy integrations** with tools, MCPs, and other frameworks out of the box.
- 🤝 **Support for handoffs** between agents and humans.
- 🧠 **Reasoning agnostic** works with any LLM, text agent, or chatbot code.
- 🚀 **Instant deployment** so you can build, deploy, and start talking in minutes with no infrastructure setup.

## Quickstart (< 5 minutes)

The Line SDK is designed to be used with the Cartesia's voice agent platform [Line](https://cartesia.ai/agents).
- Create a [Cartesia account](https://play.cartesia.ai).
- Follow the [quickstart guide](https://docs.cartesia.ai/line/start-building/talk-to-your-first-agent).

And you'll be able to make your first voice call in a few minutes.

## Install the SDK

```zsh
pip install cartesia-line
```


## Common Use Cases

| Use Case | Example |
|----------|---------|
| **Basic chat** | [examples/basic_chat/](examples/basic_chat/) |
| **Form filling** | [examples/form-filling/](examples/form-filling/) |
| **Background reasoning** | [examples/sales_with_leads/](examples/sales_with_leads/) |
| **Support** | [examples/personal_banking_handoffs/](examples/personal_banking_handoffs/) |

## Going Deeper

- **More examples**: [examples/](examples/) - See all available examples and patterns
- **3rd party integrations**: [example_integrations/](example_integrations/) - See example integrations for external services

  > [!NOTE]
  > While Cartesia approves each example, they are implemented and maintained by our partners.
- **Full API reference**: [docs.cartesia.ai/line](https://docs.cartesia.ai/line/)
- **Get help**: [Discord community](https://discord.gg/cartesia)
