tinyjuice 0.1.0

Pluggable token compression for OpenHuman.
Documentation

TinyJuice is a pluggable token compression crate for OpenHuman. The goal is to provide a small Rust boundary where OpenHuman can route prompt, context, and conversation inputs through interchangeable compression strategies before model execution.

This repository is intentionally blank scaffolding right now. It defines the crate shell, contribution workflow, CI/release scaffolding, and placeholder API types. Compression algorithms, OpenHuman adapters, and benchmark claims have not landed yet.

Direction

TinyJuice is intended to support:

  • provider-neutral token input compression
  • pluggable compression strategies
  • configurable compression targets, including aggressive 80-90% reduction modes
  • inspectable compression reports for cost, quality, and safety review
  • OpenHuman integration points that can be enabled without coupling the core crate to the full OpenHuman runtime

Quick Start

Add TinyJuice to a Rust project once published:

[dependencies]
tinyjuice = "0.1"

For local development:

cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo build --all-targets
cargo test

Run the placeholder example:

cargo run --example passthrough

Crate Layout

src/
  compressor/   Compression trait and input/output types
  config/       Compression target and policy configuration
  openhuman/    Placeholder OpenHuman integration boundary
  error.rs      Shared error type

Status

TinyJuice is pre-implementation. The current PassthroughCompressor is a scaffold implementation that returns input unchanged so downstream wiring can compile while real strategies are designed and tested.