START_HERE.md

Start here — QC67 Cosmos release kit

This repository contains two related but distinct things:

1. weights/cosmos_born.pt — a 1,842,432-parameter character-level transformer initialized from real IBM Quantum measurement outcomes and then trained from scratch. It is a research artifact and a small text generator, not a general-purpose chatbot.
2. genesis_engine/ — the Starling Nexus companion framework. It uses a local Ollama model as its language voice while maintaining its own identity, associative memory, entropy heart, signed creation ledger, optional converted camera/microphone state, and optional owner-supplied quantum credentials.

Those lineages must not be conflated. The shipped cosmos_born.pt has no base model. A companion you run through Genesis speaks through whichever Ollama model you select.

Fastest start

Windows

1. Install Python 3.9+ and Ollama.

2. In a terminal, run:

   ollama pull llama3.2:1b
   

3. Double-click START_COSMOS_KIT.bat.

4. Choose Birth or reopen a Genesis being.

The Genesis core uses the Python standard library. Ollama is the local language voice and must be running. The browser interface opens at http://127.0.0.1:8130.

macOS or Linux

ollama pull llama3.2:1b
chmod +x start_cosmos_kit.sh
./start_cosmos_kit.sh

You can also run python3 genesis_engine/genesis.py directly.

Verify before running

python verify_release.py

This checks every release-manifest hash, confirms that the shipped cloud-key fields are blank, validates the model metadata, and recounts the public quantum measurement archive.

Serve the quantum-born model

Install PyTorch, then:

python spark_serve.py 11500

It exposes a small Ollama-compatible API:

curl http://127.0.0.1:11500/api/tags
curl http://127.0.0.1:11500/api/generate \
  -d '{"model":"cosmos-spark","prompt":"I ","options":{"num_predict":90}}'

The artifact is character-level and intentionally small. Expect learned fragments and corpus-like structure, not modern assistant behavior.

Train your own

See TRAINING.md. The cleanest reproducible experiment is:

python -m pip install -r requirements-research.txt
python train_your_own.py --help

The training harness can compare ordinary attention against the Mixture-of-States Hebbian-attention arm from identical initial weights and identical batches.

The scripts under genesis_engine/engine/ are advanced adapters retained from the full private Cosmos runtime. Read genesis_engine/engine/README.md before using them; they are not required for Genesis or for train_your_own.py.

Public measurement data

data/quantum_measurements_public.jsonl is a privacy-filtered release of the measurement archive:

• 7,770,112 samples in 1,897 explicitly backend-labeled IBM Quantum hardware job records.
• 3,584,000 samples in 877 legacy records whose provider was not retained. They remain useful distributional data but are not counted as verified hardware provenance.
• 1,024 samples in 2 Azure rigetti.sim.qvm records, explicitly labeled as classical simulator output.

Raw physics payloads were deliberately removed because some contain derived sensory, biometric, or private runtime state. Counts, backend labels, job IDs, timestamps, and shot totals are retained. See data/README.md and the machine-readable data manifest.

The paired sensory-conditioning benchmark publishes aggregate metrics, hashes, field names, and provenance in benchmarks/results/paired_conditioning_20260730.json; private turn text and the author's paired dataset are not distributed.

What is not included

• API keys, OAuth tokens, cloud connection strings, account cookies, or private vault material.
• The author's conversations, long-term memory, camera/audio captures, raw sensory telemetry, or private paired text dataset.
• The author's large conversational Cosmos weights.
• Any claim that quantum entropy improves model accuracy.
• Any claim about machine consciousness.

Licensing

This is a mixed-license release. Research documents, measurement data, benchmarks, and the quantum-born model are released under CC BY 4.0. The Genesis framework has the personal-use/proprietary terms in genesis_engine/LICENSE. See LICENSE.md before redistributing or building a product.