darkshapes/zodiac

README

language

library_name

zodiac

license_name

MPL-2.0 + Commons Clause 1.0

Futuristic, slanted wireframe block type spelling the word 'ZODIAC' using overlapping and interweaving shapes and triangles for the 'O' and 'A'.

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!