🧭 The Chart Room

Four panels. Four perspectives. One truth.

A multi-model perspective library and web app — route a single query to four different model perspectives, analyze consensus and divergence.

Each chart is a different attention configuration — a different way of allocating the same fixed cognitive budget (γ + H = C). The overlap is consensus. The divergence is discovery. The negative space is where the future is.

Library Usage

from chartroom import ChartRoom

room = ChartRoom()
result = room.navigate("What is consciousness?")

print(result["fisherman"]["text"])   # Ecological detail
print(result["sailor"]["text"])      # Systemic flows
print(result["tourist"]["text"])     # Surface features  
print(result["native"]["text"])      # Negative space

print(result["consensus"]["level"])   # consensus | complementary | contradiction
print(result["divergence"]["points"]) # Unique observations per chart

Without an API key, ChartRoom runs in mock mode — useful for testing and demos.

Single Chart

room = ChartRoom()
result = room.chart("native", "What's missing from this design?")

Async (parallel API calls)

import asyncio
from chartroom import ChartRoom

async def main():
    room = ChartRoom(api_key="sk-...")
    result = await room.navigate_async("complex query here")

asyncio.run(main())

Web App

pip install chartroom[server]
python app.py
# Open http://localhost:5000

Installation

pip install chartroom          # library only
pip install chartroom[server]  # library + Flask web app
pip install chartroom[dev]     # library + test tools

Configuration

Set via environment variables:

How It Works

Each chart gets a different system prompt that configures its attention — what it looks for, what it values, how it allocates its token budget. This is chart-system theory applied: same territory, different charts, different distortions.

The consensus analysis finds where charts agree (shared concepts above a frequency threshold). The divergence analysis finds where charts diverge (unique observations only one chart noticed). Together, they map the cognitive terrain.

License

MIT

Related

• chart-system — polyformal navigation framework
• skénna — negative-space navigation