README.md
March 14, 2026 · View on GitHub
NeuralConnect
A Memory-Driven Multi-Agent NPC Experience Powered by EverMemOS.
An iOS narrative mystery set aboard a Mars-bound cyberpunk shuttle, where you explore the ship, listen in on NPC conversations, and use Neural Connect to dive into what characters remember, connect the clues, and uncover the truth.
Demo Video
TestFlight Beta
https://testflight.apple.com/join/KgeybCZp
iOS iPhone version available now.
What players do
NeuralConnect is built around a simple loop:
- Explore a 2D shuttle map (tap to move).
- Listen when multiple NPCs are nearby.
- Connect to a single NPC to review their memory trail.
- Investigate with a visual clue board that grows as you learn more.
The ship is divided into six zones: Gym, Medbay, Lab, Power Room, Bar, Casino.
Key features
- AI-driven dialogue between NPCs (with fallback when AI is unavailable)
- Persistent character memory so NPCs can build context over time
- Clue board / knowledge graph that helps you spot relationships and recurring topics
- English / 中文 support
Characters
 Captain Acting Captain First time on the Mars route. Former freight hauler who took this position at any cost — but his true purpose remains unknown. |
 Doctor Ship Doctor / Cybernetic Surgeon Fifteen years in cybernetic surgery. Seems unusually fascinated by prosthetic modifications — perhaps too fascinated. |
 AI Android Navigation Assistant She knows everyone's secrets. But her core protocols forbid her from speaking them aloud. |
 Attendant Flight Attendant Three years as a flight attendant. Has an almost obsessive curiosity about the AI Android. |
 Gym Guy Regular Passenger Runs ten kilometers daily. Constantly reminisces about his hydroelectric station job — as if he's running from something. |
 The Stowaway Odd-jobs Hand Stowed away on this ship — a feat even the world's best hacker would find difficult to pull off. |
Emergent NPC dialogue samples
Full simulation logs — 30 AI-generated conversations where NPCs build memories, form relationships, and reveal secrets over time:
Modes & settings (in-app)
From the gear icon you can:
- Switch Language (English / 中文)
- Choose the AI dialogue engine (optional)
- Configure the memory backend (optional)
- Delete all NPC memories (for a clean playthrough / testing)
- Replay the intro story sequence
Getting started (dev)
Requirements
- Xcode 26+
- iOS 26+ (Simulator or device)
- EverMemOS backend (required to start gameplay)
- Cloud: base URL + token
- Local: base URL (no token)
- AI dialogue provider (optional)
- DeepSeek API key (recommended), or
- Apple Intelligence on-device (when available on iOS 26+)
Run
- Open
NeuralConnect.xcodeproj - Select a destination
- Build & Run
First-run setup (in-app)
The game won’t start until EverMemOS is configured:
- Open Settings (gear icon)
- Configure EverMemOS
- Cloud: enter Base URL + Token
- Local: enter Base URL (tip: on iPhone, don’t use
localhost— use a reachable LAN IP)
- (Optional) Configure AI Dialogue Engine
- Enable DeepSeek and enter an API key, or rely on Apple Intelligence if available on your device
Future Plan
The current clue board is a concept mockup for exploration and demonstration. The goal is to evolve it into a fully functional 3D knowledge graph powered by EverMemOS's Cell architecture — where each clue becomes a living memory cell that can form dynamic connections, surface hidden patterns, and reveal the narrative as players investigate.
Privacy / data
NeuralConnect can be run in a “local-only / offline” style depending on what you enable in Settings.
If you opt in to external services, the app may send:
- NPC memory summaries/metadata to the configured memory backend
- Dialogue generation requests to the configured AI provider
Nothing is sent until you enter credentials/URLs in Settings.
Full privacy policy: docs/privacy-policy.md
Disclaimer
NeuralConnect is a creative/research prototype and is not intended for safety-critical use.
License
No license file is provided in this repository. By default, all rights are reserved by the copyright holder.