dnhkng /GLaDOS

This is the Personality Core for GLaDOS, the first steps towards a real-life implementation of the AI from the Portal series by Valve.

★ 5,777⑂ 447👁 66⑃ 118● 109▤ 1
PythonMITCreated 2023-03-23
下载:AI modelsAI-0.1 ↓0.12024-12-29
+1
日增长
5,777
stars
447
forks
66
watchers
118
prs
109
issues
1
releases

README

GLaDOS Personality Core

 "Science isn't about asking why. It's about asking, 'Why not?'" — Cave Johnson

A voice assistant with GLaDOS’s custom voice, dry humour, camera observations,
persistent memory and tools. Talk through a local microphone or the browser,
watch the animated core respond, and inspect what each mind is doing.

The project began with a simple question: could we build the personality core
from Portal? The current system combines a conversational model with independent
cores for emotion, memory, vision, system health and research. Their observations
feed a shared context, while an Autonomy Core decides when an update deserves a
spoken response.

Discord ·
Sponsor ·
Web console guide ·
Architecture

https://github.com/user-attachments/assets/c22049e4-7fba-4e84-8667-2c6657a656a0

 What it does

 "We've both said a lot of things that you're going to regret" — GLaDOS

- Voice conversation: Gemma 4 E4B can receive audio directly. An extended
  profile uses Parakeet transcription with a different conversation model.
- GLaDOS speech and animation: spoken emotion directions move the browser
  avatar; a separate Emotion Core maintains pleasure, arousal and dominance.
- A functional web console: control microphone, voice and camera; inspect
  minds, context slots, routing decisions, saved memory and background tasks.
- Vision: E4B describes the current scene and recent changes using timestamped
  images. Observation timing adapts to motion; the default range is 2–5 seconds.
- Memory and research: retain conversation summaries and useful facts,
  retrieve relevant memories, and perform requested internet research.
- Tools: connect MCP services, including Home Assistant, and use native
  controls for preferences, memory, tasks and allowlisted system commands.
- Proactive responses: independent cores publish evidence for the Autonomy
  Core to review. User interactions take priority over new background inference.

 Quick start

 "The Enrichment Center is required to remind you that the Weighted Companion Cube cannot talk. In the event that it does talk The Enrichment Centre asks you to ignore its advice." — GLaDOS

You need Git and Python 3.12 or newer to run the installer. It creates a Python
3.12.8 environment, installs GLaDOS and downloads the local ONNX speech models.
The conversation model runs in a separate server.

The reference setup uses a CUDA build of llama.cpp and Gemma 4 E4B. See the
model setup and measured results for hardware and context
capacity details; latency and memory use depend on your machine and enabled cores.

 1. Install GLaDOS

bash
git clone https://github.com/dnhkng/GLaDOS.git
cd GLaDOS
python scripts/install.py


The installer selects CUDA when its utility is available, an installed ROCm
backend otherwise, or CPU. You can override this:

bash
python scripts/install.py --backend cpu
python scripts/install.py --backend cuda
python scripts/install.py --backend amd --rocm-version 7.2.1


Choose the command for your

Top issues

Latest release

AI models 0.1 Pre-release 2024-12-29
These are the models needed for GLaDOS.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON