Metadata-Version: 2.4
Name: synthora
Version: 0.1.12
Summary: Synthora is a lightweight and extensible framework for LLM-driven Agents and ALM research. It provides essential components to build, test and evaluate agents. At its core, Synthora aims to assemble an agent with a single config, thus minimizing your effort in building, tuning, and sharing agents.
Author: Syntropix.AI
License-File: LICENSE
Requires-Python: ~=3.10
Requires-Dist: apscheduler<4,>=3.11.0
Requires-Dist: asyncio<4,>=3.4.3
Requires-Dist: docstring-parser<0.17,>=0.16
Requires-Dist: fastapi<0.116,>=0.115.5
Requires-Dist: openai<2,>=1.55.0
Requires-Dist: pydantic<3,>=2.10.1
Requires-Dist: python-dotenv<2,>=1.0.1
Requires-Dist: pyyaml<7,>=6.0.2
Requires-Dist: rich<14,>=13.9.4
Requires-Dist: websockets~=14.1
Provides-Extra: services
Requires-Dist: discord-py<3,>=2.4.0; extra == 'services'
Requires-Dist: slack-bolt<2,>=1.22.0; extra == 'services'
Provides-Extra: toolkits
Requires-Dist: googlesearch-python<2,>=1.2.5; extra == 'toolkits'
Requires-Dist: pymediawiki<0.8,>=0.7.5; extra == 'toolkits'
Requires-Dist: trafilatura<3,>=2.0.0; extra == 'toolkits'
Requires-Dist: wikipedia<2,>=1.4.0; extra == 'toolkits'
Description-Content-Type: text/markdown

<!-- LICENSE HEADER MANAGED BY add-license-header

Copyright 2024-2025 Syntropix

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

<div align="center">
    <img src="./assets/logo.png" alt="Synthora Logo" width="350">
</div>

<div align="center">
<a href="https://github.com/syntropix-ai/synthora/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/syntropix-ai/synthora?style=flat" alt="GitHub License">
</a>
<a href="https://twitter.com/SyntropixAI">
    <img src="https://img.shields.io/twitter/follow/SyntropixAI" alt="X Follow">
</a>
<a href="https://www.linkedin.com/company/syntropix">
    <img src="https://img.shields.io/badge/LinkedIn-Syntropix-blue?style=flat" alt="LinkedIn">
</a>
<a href="https://docs.syntropix.ai/">
    <img src="https://img.shields.io/readthedocs/synthora" alt="Read the Docs">
</a>
<a href="https://github.com/syntropix-ai/synthora">
    <img src="https://img.shields.io/github/stars/syntropix-ai/synthora?style=flat&logo=github&color=gold" alt="GitHub Stars">
</a>
</div>

## 📖 Introduction

Synthora is a lightweight, extensible framework for LLM-driven agents and ALM research. It provides the essential components to build, test, and evaluate agents, enabling you to assemble an agent with a single configuration file. Our goal is to minimize effort while delivering robust functionality.

> **Note:** This project is in its early stage of development. The APIs are subject to significant changes, which may introduce breaking updates. Use with caution and consider the risks associated with adopting an evolving framework. We welcome your feedback and contributions to improve this project together!

## 💡 Core Features

Synthora offers a comprehensive suite of features designed to support your AI development needs:

- **Config-Driven Assembly:** Assemble agents and conduct chats with simple configurations.
- **Agents:** Includes various predefined agents (e.g., COT, TOT, ReAct) and supports custom agent creation.
- **Tools:** A comprehensive tool set is integrated for agents to call, unleashing the full power of agents.
- **Task Automation:** Employ powerful workflows to automate and streamline diverse tasks.
- **Multi-Agent Interactions:** Easily combine multiple agents using configuration files or straightforward code.
- **Extensibility:** Leverage a lightweight and highly extensible framework that integrates seamlessly with additional tools.
- **State-of-the-Art Workflows:** Align your work with cutting-edge AI research and practices.

## ⚙ Installation

Install the Synthora Python Library from PyPI with a single command:

```shell
pip install synthora
```

## ✨ Quick Start

### Chat with an Agent

Engage in a conversation with a prebuilt Vanilla Agent:

```python
from synthora.callbacks import RichOutputHandler
from synthora.agents import VanillaAgent

agent = VanillaAgent.default("You are a Vanilla Agent.", handlers=[RichOutputHandler()])
agent.run("Hi! How are you?")
```

### Define a Tool

Create a simple tool to add two numbers using the provided decorator:

```python
from synthora.toolkits.decorators import tool

@tool
def add(a: int, b: int) -> int:
    r"""Add two numbers together."""
    return a + b
```

### Build a Workflow

Construct a workflow that chains tasks together:

```python
def add(x: int, y: int) -> int:
    return x + y

flow = (BaseTask(add) | BaseTask(add)) >> BaseTask(add)
flow.run(1, 2)
```

## 📃 Documentation

For detailed information on core modules, tutorials, and cookbooks, please visit our [Documentation](https://docs.syntropix.ai/en/latest/).

## 🌎 The Ecosystem

Synthora is a core component of the **Syntropix Ecosystem**, serving as the hub for our tech stack and community engagement.

![figure](./assets/ecosystem.png)

We also offer a backend API platform, **Syntropix**, which provides a low-cost, efficient CPU-accelerated inference service—the first of its kind in heterogeneous acceleration. Using Syntropix as your backend API in Synthora unlocks additional benefits:

- Detailed observability, analysis, and evaluation.
- Finer-grain control over inference services, including scheduled jobs.
- More advanced features and functionalities in the pipeline.

For further details, check out:

- [Syntropix Homepage](https://syntropix.ai/)
- [Syntropix Playground (Coming Soon)]()

## 🧠 Contributing

We’re in the early stages of Synthora’s development, and your contributions are crucial to shaping its future. Whether you're a developer, researcher, or enthusiast, your feedback and code contributions are welcome and highly valued. If you encounter issues, have ideas for enhancements, or want to contribute new features, please get involved! Check our GitHub repository for guidelines on how to contribute, submit issues, and propose pull requests.

Together, we can build a robust and innovative framework that meets the needs of the AI research community. Join us on this journey, and help shape the future of agent-driven AI!
