Skip to content

PlagueHO/prompt-babbler

Repository files navigation

Prompt Babbler

CI CD License Azure IaC

💬 Prompt Babbler is a speech-to-prompt web application that captures stream-of-consciousness speech, transcribes it using Azure AI Foundry, and generates structured prompts for target systems like GitHub Copilot. It can run locally with a Cosmos DB emulator or be deployed to Azure with a fully managed Cosmos DB instance and Azure AI Foundry resources. The app is built with a React frontend and a .NET backend, orchestrated by .NET Aspire for seamless local and cloud development.

What It Does

Prompt Babbler turns rough speech into polished, structured prompts ready to use with AI tools. The typical workflow is:

  1. Record — Click record and speak your thoughts out loud, stream-of-consciousness style.
  2. Transcribe — Azure AI Speech Service converts your audio to text in real time.
  3. Generate — The app sends your transcription through a configurable prompt template and calls an Azure OpenAI model to produce a structured, ready-to-use prompt.
  4. Use — Copy the generated prompt into GitHub Copilot, an AI assistant, an image generator, or any other AI tool.

Key Features

  • Real-time speech transcription via Azure AI Speech Service — see your words appear as you speak.
  • Prompt templates — Create and manage reusable templates that shape how your transcription is turned into a prompt. Templates support structured instructions, output format, guardrails, examples, and tags.
  • Prompt history — Every generated prompt is saved alongside its source transcription (called a babble) so you can review and reuse past outputs.
  • Multi-target support — Included built-in templates for GitHub Copilot, general AI assistants, and image generators.
  • Single-user and multi-user modes — Run privately without authentication, or enable Microsoft Entra ID for multi-user access.
  • Fully cloud-native — Deploys to Azure Static Web Apps + Azure Container Apps with Cosmos DB and Azure AI Foundry, all provisioned via Bicep.

Quick Start

For full setup instructions including prerequisite installation, see docs/QUICKSTART-LOCAL.md. To deploy to Azure, see docs/QUICKSTART-AZURE.md.

Prerequisites to run Locally

  • An Azure Account with Contributor access to allow Aspire to provision Azure AI Foundry resources for the app
  • Aspire CLI to orchestrate the components
  • Azure CLI to authenticate and allow Aspire to provision Azure AI Foundry resources in your subscription
  • Install Docker Desktop to host Cosmos DB emulator (Windows/Linux/Mac)

Run Locally

git clone https://github.com/PlagueHO/prompt-babbler.git
cd prompt-babbler

# Sign in to Azure (one-time — Aspire provisions cloud AI resources)
az login --tenant <your-tenant-id>

# Start everything via Aspire
aspire run

Aspire handles all dependency installation, builds, and orchestration automatically. On first run it provisions Azure AI Foundry resources and starts a Cosmos DB emulator in Docker — this takes several minutes. Subsequent runs start quickly.

Documentation

Document Description
Architecture Tech stack, project structure, API endpoints, data model, infrastructure
Local Development Run locally with .NET Aspire
Deploy to Azure Deploy to Azure with Azure Developer CLI
API Reference Full API reference with request/response schemas
CI/CD Setup GitHub Actions pipeline configuration
Infrastructure Azure Bicep infrastructure details

License

MIT

About

A simple React app that converts voice-dictated stream-of-consciousness into structured prompts for various AI platforms.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors