vee1e/InstaFuel_Chatbot_public
1
0
Fork 0
mirror of https://github.com/vee1e/InstaFuel_Chatbot_public.git synced 2026-09-01 18:57:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
mirror of https://github.com/vee1e/InstaFuel_Chatbot_public -
1 commit 1 branch 0 tags 313 KiB
Find a file
Exact
vee1e f66180ab55
Initial commit
2026-04-21 11:57:37 +05:30
config Initial commit 2026-04-21 11:57:37 +05:30
data Initial commit 2026-04-21 11:57:37 +05:30
docs Initial commit 2026-04-21 11:57:37 +05:30
frontend Initial commit 2026-04-21 11:57:37 +05:30
scripts Initial commit 2026-04-21 11:57:37 +05:30
src Initial commit 2026-04-21 11:57:37 +05:30
tests Initial commit 2026-04-21 11:57:37 +05:30
.gitignore Initial commit 2026-04-21 11:57:37 +05:30
api_usage.md Initial commit 2026-04-21 11:57:37 +05:30
available_models.md Initial commit 2026-04-21 11:57:37 +05:30
chat.py Initial commit 2026-04-21 11:57:37 +05:30
docker-compose.yml Initial commit 2026-04-21 11:57:37 +05:30
Dockerfile Initial commit 2026-04-21 11:57:37 +05:30
prototype_flow.py Initial commit 2026-04-21 11:57:37 +05:30
README.md Initial commit 2026-04-21 11:57:37 +05:30
report.md Initial commit 2026-04-21 11:57:37 +05:30
requirements.txt Initial commit 2026-04-21 11:57:37 +05:30
run.sh Initial commit 2026-04-21 11:57:37 +05:30
run_chat.py Initial commit 2026-04-21 11:57:37 +05:30

README.md

Fitness Supplement Multi-Agent Chatbot System

Overview

A comprehensive multi-agent chatbot system designed for an e-commerce fitness supplements brand, built with Google ADK (Agent Development Kit) and agentic workflows using Google Cloud AI Platform and Vertex AI. sc

Key Features

  • Friendly & Motivational Tone: Like a fitness coach
  • Real-time Order Tracking: E-commerce API integration
  • Personalized Recommendations: Goal-based supplement stacks
  • Comprehensive Knowledge Base: Products, FAQs, usage guides
  • Performance Analytics: Conversion tracking and optimization

KPIs

  • Conversion rates
  • Customer satisfaction scores
  • Support load reduction
  • Response accuracy

Quick Start

Simple Chat Mode (Recommended for testing)

# Install dependencies
pip install -r requirements.txt

# The .env file is already configured with your API key
# Run the simple chat interface
python run_chat.py

Run automated checks

pytest

Full Agent System (Advanced)

# For the complete multi-agent system
uvicorn src.api.server:app --host 0.0.0.0 --port 8000 --reload

Manual Chat

# Direct chat with Google Gemini
python chat.py

Chat persistence with DuckDB

  • Conversations and user context are persisted automatically in a DuckDB database. The store supports multiple deployment options:
    • Local file: data/chat_store.duckdb (default)
    • MotherDuck cloud: Set CHAT_STORE_PATH=md:my_db and MOTHERDUCK_TOKEN=<token>
    • S3: Set CHAT_STORE_PATH=s3://bucket/path/chat.duckdb (requires AWS credentials)
    • EC2/NFS: Mount shared storage and set CHAT_STORE_PATH=/mnt/shared-storage/chat.duckdb
  • The CLI (run_chat.py) now exposes a :context {"goal": "lean bulk"} command so you can insert structured context without sending a model prompt. Stored context is injected into every downstream QueryEngine call.
  • The FastAPI endpoint (POST /chat) stores every turn along with any user_context payload sent in the request. Provide JSON to have fields tracked individually; repeated keys keep the value from the newest message timestamp. A user_id is created the first time you hit the API, and every response now returns both user_id and conversation_id. Include both IDs on follow-up calls—if the pair doesn't match what's on disk the API returns 403 Conversation ID does not belong to the provided user.

License

Proprietary - InstaFuel Brand