statek 1.0.0

No project description provided

Stateful Temporal LLM Orchestrator

A Python package for stateful temporal LLM orchestration.

Installation

From Source

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:

# Create virtual environment
python -m venv venv

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

# Activate on Windows
venv\Scripts\activate

Install development dependencies:

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

Building the Package

Build source distribution:

./scripts/build.sh

Or manually:

python -m build --sdist --wheel

Running Tests

pytest

Code Quality

Run linters:

./scripts/run_lint.sh

This will run pylint for code quality checks.

Docker

Build and run the package in Docker:

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