git404hub

what is bcthack fr?

matt-wisdom/bcthack — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · moderate

tl;dr

A hackathon project that simulates consumer behavior, generating persona-based product reviews and recommendations shaped by local economic data.

vibe map

mindmap
  root((repo))
    What it does
      Persona simulation
      Product recommendations
    Tech stack
      FastAPI
      LangGraph
      ChromaDB
    Use cases
      Synthetic reviews
      Consumer research
    Audience
      AI researchers
      Hackathon builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate a synthetic product review written from the perspective of a described customer persona.

VIBE 2

Get product recommendations tailored to a persona's interests and local economic conditions.

VIBE 3

Study how memory and economic context could shape an AI agent's simulated purchasing decisions.

what's the stack?

PythonFastAPILangGraphChromaDBDocker

how it stacks up fr

matt-wisdom/bcthack0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity4/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 1h+

Requires Docker Compose and a Google Gemini API key (or a local Ollama instance).

No license file is mentioned in the README, so terms of reuse are unclear.

in plain english

RecAgent is a consumer agent framework built for a hackathon that simulates how a real person might research and respond to products. It models cognitive memory in three layers: a fast sensory layer for processing raw product and environment data, a short term layer for managing the current session context, and a long term layer backed by a vector database that stores past behaviors and insights, with a mathematical forgetting mechanism so older memories fade over time. The system takes a persona description, for example a price conscious student from Lagos who loves photography, and uses that profile alongside real time economic data such as inflation rates and exchange rates specific to the persona's country to reason about whether a product fits that person's actual purchasing situation. It can search a local product catalog offline or use a web search tool to find products in real time. The framework exposes two main API endpoints. One generates a product review from the perspective of the described persona. The other generates personalized product recommendations based on the persona's interests, drawing from product datasets including Amazon, Jumia, and a local store catalog. You would use this if you are building or experimenting with AI agents that simulate consumer behavior, for example to generate realistic synthetic reviews, test how different personas respond to product recommendations, or study how economic context affects purchasing decisions. The backend is a containerized FastAPI application using LangGraph for agent reasoning, ChromaDB for vector database memory, and a language model for complex reasoning. It is written in Python and runs via Docker Compose.

prompts (copy fr)

prompt 1
Explain how the tri-layer memory system in RecAgent decides what to forget over time.
prompt 2
Walk me through setting up RecAgent with Docker Compose and a Gemini API key.
prompt 3
Help me call the /recommendations/generate endpoint with a custom persona.
prompt 4
Show me how offline mode differs from online mode for product discovery here.

Frequently asked questions

what is bcthack fr?

A hackathon project that simulates consumer behavior, generating persona-based product reviews and recommendations shaped by local economic data.

What language is bcthack written in?

Mainly Python. The stack also includes Python, FastAPI, LangGraph.

What license does bcthack use?

No license file is mentioned in the README, so terms of reuse are unclear.

How hard is bcthack to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is bcthack for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.