# aki-008/evaluation-ai-hybrid-chat architecture

> Architecture diagram of the GitHub repository aki-008/evaluation-ai-hybrid-chat, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aki-008/evaluation-ai-hybrid-chat
- Repository: https://github.com/aki-008/evaluation-ai-hybrid-chat

## Overview

##### File structure
- Top-level Python scripts:
- config.py – central configuration (credentials, endpoints)
- load_to_neo4j.py – builds the graph database from the JSON dataset
- pinecone_upload.py – builds the vector index in Pinecone
- hybrid_chat.py – the core chat interface combining graph + vector retrieval
- visualize_graph.py & neo4j_viz.html – graph visualization tools
- requirements.txt – dependencies (e.g., neo4j, pinecone-client, OpenAI)
- vietnam_travel_dataset.json – source data for ingestion
- AI_hybrid_chat_evaluation.pdf – likely design or evaluation report
- No frontend vs. backend, but distinct components: data ingestion, storage layers, chat logic, visualization.

##### README for additional insights
- README only says “first commit,” so the architecture must be inferred from file names.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Ingestion Layer
    subgraph "Ingestion Layer"
        data["vietnam_travel_dataset.json"]:::artifact
        load_neo["load_to_neo4j.py"]:::service
        pine_upload["pinecone_upload.py"]:::service
    end

    data -->|reads| load_neo
    data -->|reads| pine_upload
    load_neo -->|graph create| neo4j["Neo4j Graph DB"]:::db
    pine_upload -->|vector upsert| pinecone["Pinecone Vector Store"]:::db

    %% Configuration Component
    subgraph "Configuration"
        config["config.py"]:::config
    end

    config --> load_neo
    config --> pine_upload
    config --> hybrid
    config --> viz_script

    %% Application Layer
    subgraph "Application Layer"
        hybrid["hybrid_chat.py"]:::service
    end

    hybrid -->|vector query| pinecone
    hybrid -->|graph query| neo4j

    %% Visualization Layer
    subgraph "Visualization Layer"
        viz_script["visualize_graph.py"]:::service
        viz_html["neo4j_viz.html"]:::artifact
    end

    viz_script -->|graph query| neo4j
    viz_script --> viz_html

    %% Supporting Files
    subgraph "Supporting Files"
        req["requirements.txt"]:::doc
        readme["Readme.md"]:::doc
        report["AI_hybrid_chat_evaluation.pdf"]:::doc
    end

    %% Click Events
    click data "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/vietnam_travel_dataset.json"
    click load_neo "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/load_to_neo4j.py"
    click pine_upload "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/pinecone_upload.py"
    click config "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/config.py"
    click hybrid "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/hybrid_chat.py"
    click viz_script "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/visualize_graph.py"
    click viz_html "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/neo4j_viz.html"
    click req "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/requirements.txt"
    click readme "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/Readme.md"
    click report "https://github.com/aki-008/evaluation-ai-hybrid-chat/blob/main/AI_hybrid_chat_evaluation.pdf"

    %% Styles
    classDef db fill:#ADD8E6,stroke:#000;
    classDef service fill:#90EE90,stroke:#000;
    classDef artifact fill:#FFA500,stroke:#000;
    classDef config fill:#D3D3D3,stroke:#000;
    classDef doc fill:#F0E68C,stroke:#000;
```
