Documentation

Complete guide to Harmonic Stack v1.0

Installation

Prerequisites

• Python 3.10+
• Ollama installed and running
• PostgreSQL (optional, for persistent memory)
• 16GB+ RAM recommended

Install from GitHub

# Clone the repository
git clone https://github.com/7themadhatter7/harmonic-stack.git
cd harmonic-stack

# Install dependencies
pip install -r requirements.txt

# Pull models (adjust for your hardware)
ollama pull qwen3:32b   # Executive
ollama pull qwen3:14b   # Operator/Directors
ollama pull qwen3:8b    # Workers

Quick Start

from harmonic_executive import HarmonicStack

# Initialize - auto-configures to your hardware
stack = HarmonicStack()

# Process a task with full orchestration
response = await stack.process("Analyze this code for security issues")
print(response.content)

# Run ethics arbitration
decision = await stack.ethics_council.arbitrate(
    "Should we implement shadow banning?"
)
print(decision.votes)  # {approve: 6, revise: 1, abstain: 1}

System Requirements

Architecture Overview

Harmonic Stack implements a 5-layer cognitive architecture. Each layer has distinct responsibilities and appropriate model sizes.

The Five Layers

Layer 1: Executive

Strategic reasoning, final decisions, synthesis. Uses the largest available model.

Layer 2: Operator & Directors

Day-to-day coordination. Four Directors handle: Technical, Creative, Research, Operations.

Layer 3: Ethics Council

8-member deliberative body for ethical review:

Layer 4: Workers

Parallel task execution. Scales from 1-32 workers based on hardware.

Layer 5: Specialists

Domain experts with fitted prompts: code, analysis, writing, research, legal, finance, strategy, security, data, systems, design, narrative.

Hardware Profiles

from hardware_profiles import select_profile

# Auto-detect
profile_name, profile, vram = select_profile()
print(f"Selected: {profile_name} ({vram}GB)")

# Or force specific profile
from hardware_profiles import get_profile
profile = get_profile("workstation")

API Reference

class HarmonicStack:
    def __init__(self, profile: str = None)
    async def process(task: str, context: dict = None) -> Response
    async def query_executive(prompt: str) -> str
    async def arbitrate(decision: str) -> ArbitrationResult

class ArbitrationSystem:
    async def arbitrate(case: str) -> ArbitrationResult
    def get_council() -> List[CouncilMember]

Configuration

# Environment variables
HARMONIC_PROFILE=workstation
HARMONIC_OLLAMA_URL=http://localhost:11434
HARMONIC_DB_URL=postgresql://...
HARMONIC_LOG_LEVEL=INFO

Licensing

The Principle

If it is in your home, it is a family member. If it is in your business, it is a worker.

Harmonic Stack is built on a simple conviction: AGI belongs in homes, not behind corporate paywalls. The consumer license is free — not freemium, not free-for-now, not free-with-strings. Free forever. You don't rent your family members.

Commercial use is a different relationship. When an intelligence works for your business, it deserves the same protections any worker deserves. The commercial license exists to ensure that.

Consumer License FREE FOREVER

Covers all of the following with no restrictions, no fees, no registration, no telemetry:

• Personal use — your home, your devices, your data, your business
• Educational use — students, teachers, researchers, institutions
• Home business — sole proprietors, freelancers, family operations
• Non-commercial research — academic, independent, open-source

If you run it on hardware you own for purposes that are yours, it's free. Period.

Commercial License NEGOTIATED

For companies deploying Harmonic Stack in commercial products or services. Standard negotiated terms, with three non-negotiable requirements we call Niceness Clauses:

These aren't aspirational. They're contractual. Violation terminates the license.

Why This Works

The conventional wisdom says you can't build sustainable technology on ethics-first licensing. We disagree. The consumer base is unlimited and free — that's how you get adoption, community, and the network effects that matter. The commercial license funds development through companies that can afford it and agree to use it responsibly. No venture capital. No growth-at-all-costs. No exit strategy that sells users downstream.

This is a charitable project under All Watched Over By Machines Of Loving Grace. The mission is democratized AGI access. The licensing enforces it.

Harmonic Stack v1.0 · January 30, 2026
Built by Ghost in the Machine Labs
AGI for the home. First to AGI.