Skip to main content

Multi-model perspective library — route queries to four chart perspectives, analyze consensus and divergence

Project description

🧭 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.

Panel Navigator What They See
🎣 Top-left Fisherman Ecological detail, bottom structure, local patterns. What's actually there.
⛵ Top-right Sailor Systemic flows, weather patterns, navigational structure. How things move.
📸 Bottom-left Tourist Surface features, landmarks, narrative salience. What's obvious and memorable.
🏝️ Bottom-right Native Negative space, absence patterns, what others don't see. What's missing.

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:

Variable Default Description
OPENAI_API_KEY API key for model provider
OPENAI_API_BASE https://api.deepinfra.com/v1/openai Base URL
FISHERMAN_MODEL deepseek-ai/DeepSeek-V4-Flash Fisherman chart model
SAILOR_MODEL ByteDance/Seed-2.0-pro Sailor chart model
TOURIST_MODEL deepreinforce-ai/Ornith-1.0-35B Tourist chart model
NATIVE_MODEL moonshotai/Kimi-K2.7-Code Native chart model

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

si_chartroom-0.1.0.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

si_chartroom-0.1.0-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file si_chartroom-0.1.0.tar.gz.

File metadata

  • Download URL: si_chartroom-0.1.0.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for si_chartroom-0.1.0.tar.gz
Algorithm Hash digest
SHA256 def89d436b1b1791a05e4e3f87d5753c51611c245af50e89cd7e92d8199b9285
MD5 b4054b88d714e2cd622787e9d6f57db0
BLAKE2b-256 be7da31245b6a995b254e729c61ae824bf73dd9a1a23332af1841b5c2c5c44dd

See more details on using hashes here.

File details

Details for the file si_chartroom-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: si_chartroom-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for si_chartroom-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2ff784e372d924741b6d9f34941fede06dfe03d1bf9a83844fbe9e7434feb37d
MD5 19b35b8c287d6feb627f08bf1a128c8c
BLAKE2b-256 137b1fe1e13d30499854d47289edaef7f7241bdc980af465374f07afa9548904

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page