Quick Start

🚀 Quick Start

Prerequisites

Requirement	Minimum Version
Python	3.10+ (3.14 fully supported)
Node.js	18+ (for React component tests)
Git	Any recent version
Docker	Optional — for container deployment

---

1. Clone & Automated Install

git clone https://github.com/cvsz/zasi.git
cd zasi
./install.sh

install.sh performs:

1. Python version detection
2. Writes config/zasi_config.json
3. Runs React component tests (node tests/test_components.js)
4. Runs 172-test Python suite (python3 -m unittest discover -s tests -q)
5. Builds wheel + tarball (python3 -m build)
6. Installs CLI to system path (/usr/local/bin/zasi)

---

2. Launch the Web Cockpit

make server
# → http://localhost:8080

Or with custom port:

ZASI_PORT=9000 python3 backend/server.py

---

3. Run the Full Test Suite

make test-all
# Runs: unit tests + API integration + React components + coverage report

---

4. Docker Deployment

make docker-build    # build image zasi:latest
make docker-run      # run on port 8080 with data/ volume

Or manually:

docker compose up -d

---

5. Electron Desktop App

npm install
npm run electron

---

6. CLI Interactive Shell

zasi

Runs the full 176-subsystem dialectical pipeline interactively.

---

7. Install from PyPI wheel

pip install dist/zasi-32.0.0-py3-none-any.whl