NPC Village

Project Description

NPC Village is a conversational AI web application that creates persistent, personality driven interactions with three distinct AI powered characters who remember past conversations. Built with Flask and the Anthropic Claude API, the system implements a stateful memory architecture where each NPC maintains individual relationship progression across user sessions through SQLite database storage. The application features a gradient-styled frontend with geometric character representations, session-based authentication with secure password hashing, and a RESTful API managing conversation flow, memory summarization, and relationship level calculations. Each NPC operates with unique personality prompts defining conversational tone and behavior patterns, while the backend dynamically builds context aware system prompts by combining personality definitions with stored conversation summaries and relationship metadata. The project demonstrates practical implementation of LLM powered applications, managing API rate optimization through conversational chunking, database schema design for multi-user NPC memory systems, and frontend backend integration handling real time chat interfaces with modal based UI patterns.