Fmind AI Assistant

An interactive professional avatar that creates a conversational Q&A experience around your resume and background.

Built with the speed of Google Mesop and the intelligence of Google Vertex AI.

Live Demo: assistant.fmind.dev

✨ Features

• ☁️ Cloud Native: Optimized for Google Cloud Run with structured JSON logging and zero-scaling capabilities.
• 🧠 Gemini-Powered: Leverages Google's state-of-the-art Gemini models for accurate, context-aware answers.
• 💬 Natural QA Interface: Engages recruiters and visitors in natural conversation about your experience.
• ⚡ Mesop UI: Fast, Python-native UI without the complexity of frontend frameworks.

🚀 Getting Started

We use modern tooling to keep development fast and clean: uv for dependency management and just for command running.

Prerequisites

• uv
• git
• just

Fast Track

# 1. Clone
git clone https://github.com/fmind/fmind-ai-assistant.git
cd fmind-ai-assistant

# 2. Install (sets up virtualenv & pre-commit hooks)
just install

# 3. Configure
cp .env.sample .env
# -> Edit .env with your Google Cloud details

# 4. Run
just app

Visit http://localhost:32123 to start chatting!

🛠️ Developer Toolkit

All common tasks are automated via just:

Command	Description
just app	Run the Mesop app locally
just check	Run type checks (ty) and linters (ruff)
just format	Auto-format code
just deploy	Deploy straight to Google Cloud Run
just clean	Remove artifacts and temporary files

📦 Deployment

Seamlessly deploy to Google Cloud Run with a single command:

just deploy

This builds from source using Google's Python buildpacks and configures the service with:

• Zero-scale (costs nothing when not in use)
• Session affinity for chat state
• Public access enabled