https://github.com/chrisrobison/ouija
A virtual ouija board featuring real-time transcription of questions and responses relayed via an animated planchette
https://github.com/chrisrobison/ouija
Last synced: 16 days ago
JSON representation
A virtual ouija board featuring real-time transcription of questions and responses relayed via an animated planchette
- Host: GitHub
- URL: https://github.com/chrisrobison/ouija
- Owner: chrisrobison
- License: mit
- Created: 2025-07-26T12:36:00.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-04-08T23:07:12.000Z (2 months ago)
- Last Synced: 2026-04-09T01:11:25.065Z (2 months ago)
- Language: HTML
- Size: 1.82 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Ouija
A virtual Ouija board built with PHP and JavaScript. It communicates with an LLM hosted via the DeepSeek API to produce short spirit responses. Spirit profiles are persisted on disk so conversations can continue across sessions.
## Features
- Spirit profiles stored in `spirits/` with conversation history.
- Special tokens like `<>` cause the backend to create and load a new spirit.
- Simple frontend (`index.html`) that displays the board and animated planchette.
- Jest tests for basic HTML behaviours.
## Setup
1. Install Node dependencies for tests:
```bash
npm install
```
2. Provide a `DEEPSEEK_API_KEY` environment variable when running `ouija.php`.
3. Serve the PHP file locally, for example:
```bash
php -S localhost:8000
```
4. Open `index.html` in your browser.
## Running Tests
Execute the test suite with:
```bash
npm test
```
## Repository Guidelines
See `AGENTS.md` for coding standards and testing requirements.