Metadata-Version: 2.4
Name: tailspin-ai
Version: 0.5.29
Summary: Token optimization and compression for Claude API requests
Author-email: Tailspin <support@tailspin.dev>
License: MIT
Project-URL: Homepage, https://github.com/z3knayr0/Tailspin-ai
Project-URL: Documentation, https://github.com/z3knayr0/Tailspin-ai/wiki
Project-URL: Repository, https://github.com/z3knayr0/Tailspin-ai
Project-URL: Issues, https://github.com/z3knayr0/Tailspin-ai/issues
Keywords: claude,api,compression,optimization,tokens
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: anthropic>=0.21.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: litellm>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"

# Tailspin AI

Token optimization and compression for Claude API requests. Reduces token usage while maintaining context quality through intelligent compression, caching, and context management.

## Installation

```bash
pip install tailspin-ai
```

## Usage

See [main Tailspin repository](https://github.com/z3knayr0/Tailspin-ai) for documentation and examples.

## Features

- **Smart Compression**: Automatic token optimization for text, code, and logs
- **Semantic Caching**: Cache-aware compression that preserves prefix stability
- **LiteLLM Integration**: Route requests to any LLM provider via LiteLLM
- **Context Management**: Intelligent context windowing and summarization
- **Compression Pipeline**: Extensible transform pipeline for custom compression logic

## Configuration

Configure via environment variables or `config.py`:

```python
litellm_enabled: bool = False
litellm_endpoint: str = ""
litellm_api_key: str = ""
litellm_provider: str = "hosted_vllm"
```

## Contributing

Contributions welcome. See [main repository](https://github.com/z3knayr0/Tailspin-ai).

## License

MIT
