Metadata-Version: 2.4
Name: statek
Version: 1.0.0
Author: Statek authors
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/yourusername/statek
Project-URL: Repository, https://github.com/yourusername/statek
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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
License-File: LICENSE
License-File: NOTICE
License-File: THIRD_PARTY_NOTICES.md
Requires-Dist: dbzero-modelkit>=1.2.0
Requires-Dist: pydantic==2.12.5
Requires-Dist: pydantic-settings==2.12.0
Requires-Dist: httpx==0.28.1
Requires-Dist: nest_asyncio==1.6.0
Requires-Dist: RestrictedPython>=8.3
Provides-Extra: dbzero
Requires-Dist: dbzero-modelkit[dbzero]>=1.2.0; extra == "dbzero"
Requires-Dist: dbzero>=0.4.2; extra == "dbzero"
Provides-Extra: dbzero-pro
Requires-Dist: dbzero-modelkit[dbzero-pro]>=1.2.0; extra == "dbzero-pro"
Requires-Dist: dbzero-pro>=0.3.3; extra == "dbzero-pro"
Provides-Extra: dev
Requires-Dist: dbzero>=0.4.2; extra == "dev"
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pylint>=3.0; extra == "dev"
Requires-Dist: build>=1.0.0; extra == "dev"
Dynamic: license-file

# Stateful Temporal LLM Orchestrator

A Python package for stateful temporal LLM orchestration.

## Installation

### From Source

```bash
git clone <repository-url>
cd statek
pip install -e .
```

## License

Statek is licensed under the Apache License, Version 2.0. See `LICENSE` for
the full license text and `THIRD_PARTY_NOTICES.md` for third-party dependency
attributions.

## Development

### Setup Development Environment

Create and activate a virtual environment:

```bash
# Create virtual environment
python -m venv venv

# Activate on Linux/Mac
source venv/bin/activate

# Activate on Windows
venv\Scripts\activate
```

Install development dependencies:

```bash
pip install -r requirements-dev.txt
# or
pip install -e ".[dev]"
```

### Building the Package

Build source distribution:

```bash
./scripts/build.sh
```

Or manually:

```bash
python -m build --sdist --wheel
```

### Running Tests

```bash
pytest
```

### Code Quality

Run linters:

```bash
./scripts/run_lint.sh
```

This will run `pylint` for code quality checks.

### Docker

Build and run the package in Docker:

```bash
docker build -t statek .
docker run -it statek
```

## CI/CD

### Continuous Integration

The project uses GitHub Actions for CI:
- Runs tests on Python 3.8, 3.9, 3.10, 3.11, and 3.12
- Executes linting checks
- Builds and validates the package

### Deployment

Deployment to the custom PyPI repository is handled by the release workflow for
this package. Run it manually with a `patch`, `minor`, or `major` version bump.
The Statek dashboard is maintained in the separate `/src/statek-dashboard`
project.

## Project Structure

```
statek/
├── .github/
│   └── workflows/        # CI/CD workflows
├── scripts/              # Build and utility scripts
├── statek/               # Main package code
├── tests/                # Test files
├── Dockerfile            # Docker build configuration
├── pyproject.toml        # Core package configuration
├── requirements.txt      # Runtime dependencies
├── requirements-dev.txt  # Development dependencies
└── README.md            # This file
```
