Downloads · 30 days
0
cognis-digital/cognis-opal
cognis-opal is a text generation model from cognis-digital. Use it when you need the model to write or continue text. It is set up for synthos. The card lists the license as apache-2.0.
Bring your own open model. Opal makes it punch far above its parameter count — privately, on your own hardware.
Downloads · 30 days
0
Access
Public
Updated Jul 5, 2026
Repo size
—
Likes
0
Public
Click a slice to open those files.
.py101 KB · 67%
From the Hugging Face model README
Bring your own open model. Opal makes it punch far above its parameter count — privately, on your own hardware.
Cognis Opal is not another set of weights. It is a model-agnostic on-device intelligence system: a commodity open GGUF + Aleph O(N) memory + hybrid retrieval + native tool-use + adaptive test-time compute, wired so a small local model beats the frontier on the axes an on-device system can actually own — privacy, cost, persistence, uncensored operation, long-context efficiency, and your private corpus that Claude/GPT/GLM structurally cannot see.
The honest thesis (this is the moat): a 4–14B model will not beat GPT-5.5 / Claude / GLM 5.2 on closed-book novel reasoning — that's a capacity wall, and physics, not marketing. Opal doesn't try to. It offloads knowledge to retrieval and computation to tools + test-time compute, so effective capability lands far above the parameter count on the tasks that matter locally. No fabricated benchmarks. That honesty is why it's worth running.
Opal is a layer, not a lock-in. Point it at any open model — each used as an attributed backend, never rebranded:
| Backend | Provider | License | Best for |
|---|---|---|---|
| Qwen3 / Qwen3.5 (4B–14B) | Alibaba | Apache-2.0 | default on-device reasoning/code |
| GLM 5.2 | Zhipu AI | open weights | strong reasoning where VRAM allows |
| Kimi | Moonshot AI | open weights | long-context / agentic (server-class) |
| DeepSeek-R1 / distills | DeepSeek | MIT | deep reasoning on GPU |
| Llama 3.x | Meta | Llama license | broadly compatible baseline |
The reference build ships on the pristine, uncensored OmniCoder-Qwen3.5-9B GGUF (never fine-tuned by us). Swap the base freely — the memory, tools, and reasoning layer are what make it Opal.
This repo is the canonical home of Cognis Opal (system + card + docs).
cognis-digital/cognis-opal-gguf — the recommended base (a quant of OmniCoder-Qwen3.5-9B, Apache-2.0, attributed). Drop the .gguf in model/ or pull the Ollama tag.BENCHMARKS.md (honest scores + the long-context/memory results that are the actual differentiator).Opal accepts images and audio, fused with your text and memory via a unified ask(text, image, audio):
SYNTHOS_VISION_*).whisper.cpp / OpenAI-compatible transcription endpoint.python -m synthos see chart.png "what's the trend?"
python -m synthos hear memo.m4a
python -m synthos ask "answer the spoken question about this chart" --image chart.png --audio q.wav
Honest design: it's describe-then-reason — the reasoner reasons over the VLM's description + the transcript + your memory (inspectable, guarded, degrades gracefully), not an end-to-end VLM. Backends are attributed open models; Opal orchestrates them, it doesn't retrain or redistribute weights.
Opal supports speculative decoding for the Qwen3 family via JetSpec-style causal parallel tree drafting — up to ~7–9× faster decoding on Qwen3-8B with identical output quality (speed, not a capability change — stated honestly).
Opal is a small stdlib Python system that orchestrates a local model backend. You bring the backend; Opal brings the memory, retrieval, tools, and test-time compute.
Prerequisites (all platforms)
numpy is installed by the setup scripts. faster-whisper is optional (only for synthos hear).Get the files once:
git clone https://huggingface.co/cognis-digital/cognis-opal
cd cognis-opal
# from the cloned folder — creates .venv, installs numpy, fetches Aleph, checks for Ollama
powershell -ExecutionPolicy Bypass -File .\install.ps1
# (optional audio backend)
$env:OPAL_WITH_AUDIO = "1"; powershell -ExecutionPolicy Bypass -File .\install.ps1
ollama pull qwen3 # or any open GGUF from the table above
.\run.cmd # == python -m synthos chat --adaptive
chmod +x install.sh run.sh
./install.sh # venv + numpy + Aleph + backend check
OPAL_WITH_AUDIO=1 ./install.sh # optional: include audio (faster-whisper)
ollama pull qwen3
./run.sh # == python -m synthos chat --adaptive
# or with make: make install && make run (make test for a no-backend smoke test)
The image ships only the Opal system (no weights). Run a model backend on the host and point
the container at it via SYNTHOS_ENDPOINT:
docker build -t cognis-opal .
# host is running Ollama on :11434
docker run --rm -it \
-e SYNTHOS_ENDPOINT=http://host.docker.internal:11434 \
-v opal-mem:/root/.synthos \
cognis-opal
# one-shot instead of interactive chat:
docker run --rm -e SYNTHOS_ENDPOINT=http://host.docker.internal:11434 cognis-opal ask "hello"
(On Linux add --add-host=host.docker.internal:host-gateway. SYNTHOS_ENDPOINT / OLLAMA_HOST
also work for native installs when your backend is not on 127.0.0.1:11434.)
python -m synthos chat --adaptive # interactive; spends compute proportional to difficulty
python -m synthos ask "explain X" # one-shot, with memory + refine
python -m synthos remember "a durable fact"
python -m synthos stats # memory + backend status
# multimodal (needs the matching backend up)
ollama pull llava # vision backend
python -m synthos see chart.png "what's the trend?" # image -> describe -> reason
python -m synthos hear memo.m4a # audio -> transcribe -> reason (needs faster-whisper)
python -m synthos ask "answer the spoken question about this chart" --image chart.png --audio q.wav
GPU path: serve the base via llama.cpp (Vulkan) or LM Studio and point Opal at it
(SYNTHOS_ENDPOINT / the commander profile). On-device profile: uncensored Qwen3-4B @ Q5 on an
Intel N150 class device (~7 tok/s, bandwidth-bound).
BENCH_NIAH.md, BUILD_STATUS.md.The Opal system (Synthos + Aleph integration) is Cognis Digital, released under Apache-2.0. Backend models are the property of their creators and used under their respective licenses (linked above) — Opal does not modify or redistribute their weights; it orchestrates them. Cite the base model you run.
<sub>Local. Private. Uncensored. Yours. If Opal earns its keep on your hardware, a ⭐ helps others find it.</sub>