File size: 2,263 Bytes
2396865 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 |
# Project Analysis: AI Agents from Scratch (Lenzcom Email/Chat)
## Overview
This project is a Node.js-based AI Chat Application hosted on Hugging Face Spaces. It serves a single-page web interface where users can interact with an AI model (dahanhstd-1.0) powered by
ode-llama-cpp. The application is designed to be self-contained, with the HTML frontend embedded directly in the server code.
## Directory Structure
- **Root**: H:\BuilddingProject\ai-agents-from-scratch
- **Source Code**:
- server.js: The main entry point. Handles HTTP requests, serves the embedded HTML, and manages the LLM inference.
- src/index.js (implied): Contains the AI logic wrapper classes (SystemMessage, HumanMessage, etc.).
- **Configuration**:
- MssterPrompt_Talk2People.txt (to be renamed): Contains the system prompt for the 'talk2people' role.
- secrets.local.md: Stores local secrets (not to be pushed).
- **Deployment**:
- hf_deploy.py: Python script for deploying to Hugging Face Spaces.
## Key Components
1. **Server (server.js)**:
- Uses express for the web server.
- Dynamically imports AI modules from ./src/index.js.
- Loads the LLM model from ./models/Qwen3-1.7B-Q8_0.gguf.
- Defines prompts for different roles ('talk2people', 'coder', 'default').
- Embeds the frontend HTML/CSS/JS in the HTML_PAGE constant.
2. **Frontend (Embedded in server.js)**:
- Simple HTML/CSS/JS interface.
- Communicates with the backend via /chat (POST) and /info (GET) endpoints.
- Handles chat history and role switching.
## Logic Flow
1. **Initialization**: Server starts, loads the LLM model (initModel()).
2. **User Request**: User sends a message via the web UI.
3. **Processing**:
- Frontend sends JSON to /chat.
- Backend constructs a message chain (System + History + User Message).
- LLM generates a response.
4. **Response**: Backend returns JSON { reply, model, ... } to the frontend.
## Current Issues & TODOs
- **File Naming**: MssterPrompt_Talk2People.txt has a typo.
- **Role/Prompt Mismatch**: The text in the prompt file does not match the 'Talk2People' persona.
- **UI Feedback**: 'Thinking' state is just '...', needs to be more descriptive.
- **Greeting**: Initial greeting is hardcoded and outdated.
|