---
title: Oneironauts
emoji: 🌙
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: 6.16.0
python_version: "3.11"
app_file: app.py
pinned: false
license: mit
short_description: A fragment of a dream becomes a branching exploration.
tags:
  - gradio
  - build-small-hackathon
  - track-2
  - llama
  - whisper
  - modal
  - track:wood
  - sponsor:modal
  - achievement:offbrand
  - achievement:fieldnotes
---

# Oneironauts

A fragment of a half-remembered dream becomes a branching, exploratory narrative. Type or speak a dream fragment, walk through scenes the dream weaver generates, make choices that shape where the dream goes, and end with a journal-voice interpretation reflecting on what your choices revealed.

Built for the Hugging Face Build Small Hackathon, **Track 2 — An Adventure in Thousand Token Wood**.

## Try it

▸ **Live app:** [build-small-hackathon/oneironauts](https://huggingface.co/spaces/build-small-hackathon/oneironauts)
▸ **Demo video:** [youtu.be/BxoNeiBMID8](https://youtu.be/BxoNeiBMID8)
▸ **Field notes:** [blog/AnimeshK509/oneironauts](https://huggingface.co/blog/AnimeshK509/oneironauts)
▸ **Social post:** [x.com/Animesh75608573/status/2066293022976069894](https://x.com/Animesh75608573/status/2066293022976069894)

## Stack

- **Llama 3.2 3B Instruct** served as a persistent Modal endpoint (A10G) — opening, branching, and closing scene generation
- **Whisper base** — voice input transcription, runs on the HF Space
- **Gradio** — frontend with custom eerie-liminal theme
- Branching state managed via `gr.State`, 4-level depth, closing scene + journal interpretation