mofirojean/soso-talk

A build with AI Bamenda project for Linguistic Inclusion # Soso Talk Voice-first Pidgin assistant for traders and farmers in Bamenda. Speak Cameroonian Pidgin into your phone, get spoken Pidgin answers about market prices and which markets are open today. Built for **Google Build with AI** — uses Gemini 2.5 Flash on Cloud Run. Designed for the GDG Bamenda AI for Linguistic Inclusion theme. ## What it solves A woman trader at Bamenda Main Market needs to know: 1. Is Mile 6 open today, or is there a ghost town order? 2. What's the price of Irish potato right now? 3. Where should she sell maize today? Today she answers these by phoning relatives and guessing. The data exists somewhere, but it lives behind French menus, login screens, and text she can't read fluently. Soso Talk removes that wall — she just talks. ## Quick start (local) ```bash npm install cp .env.local.example .env.local # add your Gemini API key from aistudio.google.com npm run dev ``` Open in **Chrome or Edge** (Web Speech API is required for voice). Tap the mic, ask in Pidgin. ## Deploy to Cloud Run Prerequisites: `gcloud` CLI installed, a GCP project, billing enabled, Cloud Run + Artifact Registry APIs enabled. ```powershell # 1. set project + region $env:PROJECT_ID = "your-gcp-project-id" $env:REGION = "europe-west1" gcloud config set project $env:PROJECT_ID # 2. enable required APIs (one-time) gcloud services enable run.googleapis.com artifactregistry.googleapis.com cloudbuild.googleapis.com # 3. build the container with Cloud Build and deploy gcloud run deploy soso-talk ` --source . ` --region $env:REGION ` --allow-unauthenticated ` --set-env-vars "GEMINI_API_KEY=YOUR_KEY_HERE" ` --memory 512Mi ` --cpu 1 ``` Cloud Build will detect the Dockerfile, build the image, push it to Artifact Registry, and deploy to Cloud Run. The command prints a `soso-talk-...run.app` URL when done. For better secret handling, replace the `--set-env-vars` line with Secret Manager: ```bash gcloud run deploy soso-talk --source . --set-sec …