Skip to content

yourmindspace/diversion_proto

Repository files navigation

🌿 yourmind.space

yourmind.space is a voice-powered AI companion designed to help you redirect your mind when you need it most. Speak freely — it listens, responds in real time, and gives you a summary of your conversation so you can reflect on what you talked about.

Built with the OpenAI Realtime API, a blazing-fast Bun + Hono backend, and a lightweight Alpine.js frontend.


✨ Features

  • 🎙️ Real-time voice conversations — Talk to an AI using the OpenAI Realtime API with live audio transcription
  • 📋 Conversation summaries — View a summary of each session after it ends
  • 📊 Dashboard — Track your sessions and usage over time with Chart.js visualizations
  • 🔐 Authentication — Secure sign-up/login powered by Better Auth
  • 📧 Email support — Transactional emails via Resend
  • 🐳 Docker ready — Containerized for easy deployment
  • 🎨 Catppuccin-themed UI — Soft, calming color palette built with Tailwind CSS

🛠 Tech Stack

Layer Technology
Runtime Bun
Web Server Hono
Frontend Alpine.js, Tailwind CSS v4
AI OpenAI Realtime API
Auth Better Auth
Database MongoDB
Email Resend
Validation Zod
Charts Chart.js
Linting Biome

🚀 Getting Started

Prerequisites

Installation

# Clone the repository
git clone https://github.com/yourmindspace/diversion_proto.git
cd diversion_proto

# Install dependencies
bun install

Environment Variables

Create a .env file in the root of the project:

OPENAI_API_KEY=your_openai_api_key
MONGODB_URI=your_mongodb_connection_string
RESEND_API_KEY=your_resend_api_key
BETTER_AUTH_SECRET=your_auth_secret

Running Locally

Build Tailwind CSS and start the dev server:

# In one terminal — watch and compile CSS
bun run css

# In another terminal — start the server
bun run dev

The app will be available at http://localhost:3000.


🐳 Docker

Build and run using Docker:

docker build -t diversion .
docker run -p 3000:3000 --env-file .env diversion

📁 Project Structure

diversion_proto/
├── pages/              # HTML page templates
│   ├── index.html      # Landing page
│   ├── dashboard.html  # User dashboard
│   ├── signup.html     # Sign up / Login
│   ├── profile.html    # User profile
│   └── summary.html    # Session summary view
├── src/                # Server-side logic
│   └── api.ts          # Hono API routes
├── styles/             # CSS source files
│   └── main.css        # Tailwind entry point
├── assests/            # Static assets
├── server.ts           # Bun server entry point
├── tailwind.config.ts  # Tailwind configuration
├── biome.json          # Biome linter config
└── Dockerfile          # Docker configuration

🎨 Color Palette

UI colors sourced from Color Hunt.

Primary accent: #cde9ab


📜 Scripts

Command Description
bun run dev Start the development server
bun run css Watch and compile Tailwind CSS
bun run build Build Tailwind CSS for production

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.


📄 License

This project is open source. See the repository for details.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors