From 060bbfb2c44143c4f2a522c035aba529c5cc80d0 Mon Sep 17 00:00:00 2001 From: talksik Date: Sun, 27 Jul 2025 14:58:00 -0700 Subject: [PATCH] docs: add readme --- ai-conversation/README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/ai-conversation/README.md b/ai-conversation/README.md index d3cf286..b85839e 100644 --- a/ai-conversation/README.md +++ b/ai-conversation/README.md @@ -1,5 +1,28 @@ # Conversation This proof of concept is for implementing conversational loop with AI at a low level with raw C. +## How it works +This simple program: +1. Captures audio samples for x seconds into a local file using alsa +2. Sends the raw pcm data to Deepgram STT API for transcription +3. Uses the transcript to call Anthropic to get an assistant's response +4. Converts Anthropic's response to audio using Deepgram's TTS +5. Plays back the generated audio from Deepgram using alsa +6. Quits. _There is no conversational loop at the time of this writing._ + ## Requirements Platform: the project is meant for Linux, specifically Ubuntu desktop. + +* libcurl +* build-essential +* libasound2-dev + +_See more deps in Makefile `install-deps` command._ + +## Getting started +1. Add `DEEPGRAM_API_KEY` and `ANTHROPIC_API_KEY` to `.bashrc` as environment variables. +2. Build & run +```sh +make +./main +```