Pre-release

This release is a pre-release and may not be stable for production use.

title: RACHEL (rachel-proxy) emoji: 🎲 colorFrom: red colorTo: blue sdk: docker app_port: 7860 pinned: false

RACHEL (rachel-proxy)

RACHEL (Rpg Agent CHat Evaluation Loop) is a FastAPI proxy that sits between JanitorAI (or any OpenAI-compatible client) and LLM completion providers (OpenRouter, OpenAI, Google Gemini, DeepSeek), running request payloads through a stateful LangGraph agent with a secure V8 code sandbox containing dice and contest RNG helper functions.

🚀 Quickstarts

RACHEL is deployed as a single-tenant desktop application.

🖥️ One-Click Desktop Launchers

Download the release zip for your operating system from Releases and launch with one click:

  • Windows: Unzip and double-click launch.bat.
  • macOS: Unzip and double-click launch.command. (If blocked by Gatekeeper, run xattr -cr launch.command in Terminal).
  • Linux: Unzip and double-click launch.sh.

💻 Developer Setup

If you are cloning this repository for local development:

  1. Install Python dependencies: 
    pip install -e ".[dev]"
  2. Build Frontend Assets (Required): The compiled static frontend directory (src/rachel/static/) is git-ignored. You MUST build the frontend before launching the backend server: 
    python scripts/build_frontend.py --target local
  3. Run the Server: 
    uvicorn rachel.proxy:app --reload --host 0.0.0.0 --port 8000
  4. Run Tests with Coverage: Ensure your code changes pass all tests and maintain at least 75% coverage: 
    pytest --cov=src --cov-fail-under=75

Initial Setup & LLM Provider Credentials

Once the proxy starts, open the Admin Console in your browser at http://localhost:8000:

  1. Proxy API Key: Enter the local admin key (printed to console logs or saved in data/proxy.key).
  2. Provider Credentials: Configure your preferred provider (OpenRouter BYOK / PKCE, OpenAI, Google Gemini, or DeepSeek) directly in the Provider Credentials card.
  3. Select your Active Provider and save settings.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for qbpo from gravatar.com qbpo

Credits

Author: neolaw

Requires

Python >=3.12

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rachel_proxy-0.1.0b0.tar.gz (295.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rachel_proxy-0.1.0b0-py3-none-any.whl (77.5 kB view details)

Uploaded Python 3

File details

Details for the file rachel_proxy-0.1.0b0.tar.gz.

File metadata

  • Download URL: rachel_proxy-0.1.0b0.tar.gz
  • Upload date:
  • Size: 295.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rachel_proxy-0.1.0b0.tar.gz
Algorithm Hash digest
SHA256 02e930aea28493ce102b399053afb108fe8aa23e752956e67d4ac30dc43c25bf
MD5 19e62a98c67401d2263ee0958aa7c484
BLAKE2b-256 514223079fc47719ce464d6b88a7ba453fd141f32d48ebbe77f23f2a13f98b74

See more details on using hashes here.

Provenance

The following attestation bundles were made for rachel_proxy-0.1.0b0.tar.gz:

Publisher: release.yml on neolaw84/rachel-proxy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rachel_proxy-0.1.0b0-py3-none-any.whl.

File metadata

  • Download URL: rachel_proxy-0.1.0b0-py3-none-any.whl
  • Upload date:
  • Size: 77.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rachel_proxy-0.1.0b0-py3-none-any.whl
Algorithm Hash digest
SHA256 11fdc5ff84ba243bafbddabf7b627751dcad3ea4df29ecc4548ac1f8b924097c
MD5 03e63be50b00cf18a5321385171c6f25
BLAKE2b-256 3c6179e0ea5e3a4bf56bec882f7a082bd6868435bd211b5a0c969d8c1a71859c

See more details on using hashes here.

Provenance

The following attestation bundles were made for rachel_proxy-0.1.0b0-py3-none-any.whl:

Publisher: release.yml on neolaw84/rachel-proxy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page