language	library_name	license_name
en	zodiac	MPL-2.0 + Commons Clause 1.0

zodiac
_{self-arranging workflow automator}

[ Windows | MacOS | Linux ]

---

Zodiac is a creative research platform for Generative AI. Guided by text, audio, or files, it identifies your models (text, image, speech, video, anything) and constructs generative AI workflows, eliminating the need for technical expertise in building action chains. It empowers users to focus on creating art, storytelling, research, and tool development, rather than the mechanics of creation, enabling exploration of emerging technology on virtually any system immediately, rather than after months of study.

Note

Zodiac runs locally and only on your devices. Outside connections are not opened. Read the code & see for yourself.

• Sequence an infinite variety of generative workflows with ease
• No programming necessary
• Minimal, lightweight and versatile: Designed for smartphone, CLI terminal and browser use
• Local-first, privacy-oriented isolation: no data siphoning, remote telemetry or analytics
• Compatible with legacy consumer computer/CPU/TPU/GPU devices,
• Bring your own models - Supports Ollama, Llamafile, Cortex/Jan, VLLM, LMStudio, HuggingFace
• Support expanding to include: , CivitAI, ModelScope & AIO (all-in-one) local caches through sdbx.
  
  

Quick Guide

Install

Install uv, then run these terminal commands

• git clone https://github.com/darkshapes/zodiac
  cd zodiac
  uv sync --group dev
  

Use

Enter a terminal and activate the python environment in

• Linux/Macos:

  source .venv/bin/activate
  

  Windows Powershell:

  Set-ExecutionPolicy Bypass -Scope Process -Force; .venv\Scripts\Activate.ps1
  

Important

Classes, Methods & Constants :

RegistryEntry
           `---------------------------Local model registry class, collects and identifies
IntentProcessor
             `-------------------------Graph of local models and execution estimator
ModelStream/TaskStream/TokenStream
                                `------Feed methods for interface operation
CueType/PkgType/ChipType Constants
                                 `-----Enumuerations of available hardware, services, and dependencies
Signatures
        `------------------------------DSPY signatures, custom routines for models
Interface
       `-------------------------------Toga GUI components

Available terminal commands:

Launch program with

• zdac
  
• or
  
• zodiac

Detailed instructions :

Discussion topics, issue requests, reviews, and code updates are encouraged. Build with us! Talk to us in our Discord!