Metadata-Version: 2.4
Name: pythbot
Version: 0.2.5
Summary: Useful AI agents in 3 lines
Project-URL: Documentation, https://insidious-snapper-3ad.notion.site/Pythbot-DocumentationDocs-2cb6997c688080f0b3eff585fdebec47
Requires-Python: >=3.9
Requires-Dist: anthropic>=0.20
Requires-Dist: fastapi>=0.100
Requires-Dist: groq>=0.4
Requires-Dist: openai>=1.0
Requires-Dist: python-dotenv
Requires-Dist: uvicorn>=0.20
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# pythbot

Useful AI agents in 3 lines.

## Install

```bash
pip install pythbot
```

## Quickstart

```python
import pythbot
from dotenv import load_dotenv
import os

load_dotenv()

@pythbot.tool
def get_weather(city: str):
    """Get the current weather for a city"""
    return f"Sunny in {city}, 28°C"

bot = pythbot.chat("You are a helpful assistant.")
bot.credentials(model="llama-3.3-70b-versatile", api_key=os.getenv("GROQ_API_KEY"), provider="groq")
bot.run()
```

## Supported providers

| Provider   | `provider=` value |
|------------|-------------------|
| OpenAI     | `"openai"`        |
| Anthropic  | `"anthropic"`     |
| Groq       | `"groq"`          |

## Tools

Any Python function becomes an AI-callable tool with one decorator:

```python
@pythbot.tool
def search_database(query: str, limit: int):
    """Search the product database"""
    return ...
```

- Type hints → JSON schema (auto)
- Docstring → tool description (auto)
- Works across all providers
