RAPP Hippocampus — Get Started

Get started in 60 seconds

# Create a project curl -fsSL https://raw.githubusercontent.com/kody-w/CommunityRAPP/main/hatch-project.sh | bash -s -- my-project # Start it cd ~/rapp-projects/my-project && ./start.sh

# Create a project irm https://raw.githubusercontent.com/kody-w/CommunityRAPP/main/hatch-project.ps1 | iex # Start it cd ~\rapp-projects\my-project; .\start.ps1

Creates an isolated project with its own virtual environment, dependencies, and local file storage. No Azure account or API keys needed to start.

What you get

🧠

Persistent memory

Facts, preferences, insights, and tasks survive across conversations and restarts.

🔌

Drop-in agents

Add a Python file to agents/ and it's auto-discovered. No config, no registration.

🔑

Auth built in

GitHub Copilot device-code auth through the chat UI. Or bring your own Azure OpenAI key.

💬

Chat UI included

Open index.html and start talking. Dark mode, markdown rendering, status indicators.

After install

Open the chat

Open index.html in your browser. It connects to your local server automatically.

Authenticate

Send a message. The UI walks you through GitHub device code auth. No manual env vars.

Talk to it

"Remember that my favorite language is Python." It stores that. Come back tomorrow, it still knows.

Add your own agents

Drop a Python file in agents/, restart. Your agent is live. See the agent guide.

LLM options

Both work locally, no Azure required.

Option	Setup	What you need
GitHub Copilot recommended	Automatic via chat UI	A GitHub account with Copilot access
Azure OpenAI	Edit `local.settings.json`	An Azure OpenAI resource

Scale when you're ready

Each tier is optional. Move forward only when you need to.

Tier 1 — Brainstem

Local dev

Runs on your machine. Local file storage, GitHub Copilot LLM, stateless agents.

→

Tier 2 — Hippocampus

Azure Functions

Persistent memory, Azure OpenAI, deploy with func publish. This is where you are.

→

Tier 3 — Nervous System

Enterprise

Copilot Studio, Teams, M365 Copilot. Generate a solution ZIP and import to Power Platform.

Resources

Chat UI GitHub repo Documentation Hatchery flow diagram Build custom agents Report an issue

Experimental research project. Managed by a v-team within Microsoft, provided as-is for the community. AI-generated output may contain errors. Memory storage formats may evolve. Feedback welcome.