MapMisfit's picture
Create app.py
5bc888a verified
import os
import gradio as gr
from dotenv import load_dotenv
import traceback # For detailed error logging
import torch # Required for Hugging Face transformers
# --- LangChain and Hugging Face Transformers Imports ---
from langchain_neo4j import Neo4jGraph
# from langchain_openai import ChatOpenAI # We will replace this
from langchain_community.llms import HuggingFacePipeline # For using HuggingFace models
from langchain_community.chains.graph_qa.cypher import GraphCypherQAChain
from langchain_core.prompts import PromptTemplate
from transformers import AutoTokenizer, AutoModelForCausalLM, pipeline
# --- Environment Variable Loading ---
load_dotenv()
print("Environment variables loaded:")
print(f"NEO4J_URI: {'Set' if os.getenv('NEO4J_URI') else 'Not Set'}")
print(f"NEO4J_USER: {'Set' if os.getenv('NEO4J_USER') else 'Not Set'}")
print(f"NEO4J_PASSWORD: {'Set' if os.getenv('NEO4J_PASSWORD') else 'Not Set'}")
# OPENAI_API_KEY is no longer the primary concern if using local/HF models
# print(f"OPENAI_API_KEY: {'Set' if os.getenv('OPENAI_API_KEY') else 'Not Set'}")
print(f"HUGGINGFACE_HUB_TOKEN: {'Set' if os.getenv('HUGGINGFACE_HUB_TOKEN') else 'Not Set (may be needed for certain models)'}")
# --- Global LangChain chain variable ---
chain = None
graph_connection_error = None # To store graph connection error
llm_initialization_error = None # To store LLM setup error
# --- Neo4j, Hugging Face LLM, and LangChain Setup ---
try:
print("Attempting to connect to Neo4j...")
graph = Neo4jGraph(
url=os.getenv("NEO4J_URI"),
username=os.getenv("NEO4J_USER"),
password=os.getenv("NEO4J_PASSWORD"),
)
print("Successfully connected to Neo4j.")
# --- Hugging Face LLM Setup ---
print("Initializing Hugging Face LLM...")
# IMPORTANT: Replace "gpt2" with your desired Hugging Face model.
# For larger models like Llama-2, ensure you have enough resources (VRAM/RAM)
# and handle authentication if it's a gated model (e.g., using huggingface-cli login
# or by passing use_auth_token=os.getenv("HUGGINGFACE_HUB_TOKEN") if supported and necessary).
model_id = "gpt2" # REPLACE THIS with your chosen model, e.g., "NousResearch/Llama-2-7b-chat-hf"
# model_id = "meta-llama/Llama-2-7b-chat-hf" # Example from the prompt, requires auth and resources
try:
tokenizer = AutoTokenizer.from_pretrained(model_id, trust_remote_code=True) # trust_remote_code might be needed for some models
# For large models, device_map='auto' and torch_dtype are crucial.
# For smaller models like gpt2, they might not be strictly necessary or could be simplified.
hf_model = AutoModelForCausalLM.from_pretrained(
model_id,
trust_remote_code=True,
device_map='auto', # Automatically distributes model layers across available devices (CPU/GPU)
torch_dtype=torch.float16, # Use float16 for memory efficiency if GPU supports it
# use_auth_token=os.getenv("HUGGINGFACE_HUB_TOKEN") # If your model requires a token
)
hf_model.eval() # Set the model to evaluation mode
# Create a text-generation pipeline
# Adjust max_new_tokens, do_sample, top_k as needed for your model and task
pipe = pipeline(
"text-generation",
model=hf_model,
tokenizer=tokenizer,
# torch_dtype=torch.bfloat16, # Alternative dtype
# device_map="auto", # Already set in model loading
max_new_tokens=512, # Max tokens for the generated Cypher query + answer synthesis
do_sample=True,
top_k=30,
num_return_sequences=1,
eos_token_id=tokenizer.eos_token_id,
pad_token_id=tokenizer.eos_token_id # Often good to set for open-ended generation
)
# Wrap the pipeline in LangChain's HuggingFacePipeline
llm = HuggingFacePipeline(
pipeline=pipe,
# model_kwargs can be used to pass additional arguments to the pipeline's __call__ method
# or to the model's generate method.
model_kwargs={'temperature': 0.1, 'max_length': 2000} # max_length here includes prompt
)
print(f"Hugging Face LLM ({model_id}) initialized successfully.")
except Exception as e_llm:
llm_initialization_error_message = f"Error initializing Hugging Face LLM ({model_id}): {str(e_llm)}\n"
llm_initialization_error_message += "Full Traceback:\n" + traceback.format_exc()
print(llm_initialization_error_message)
llm_initialization_error = llm_initialization_error_message
llm = None
if llm: # Proceed only if LLM initialized successfully
# --- GraphCypherQAChain Setup ---
print("Initializing GraphCypherQAChain...")
CYPHER_GENERATION_TEMPLATE = """You are an expert Neo4j Cypher translator.
Task: Convert the natural language question into a Cypher query that can retrieve relevant information from a Neo4j graph.
Instructions:
1. Use only the provided schema details. Do not use any other node labels or relationship types.
2. Understand the question and identify the key entities and relationships.
3. Construct a Cypher query that accurately reflects the question's intent.
4. Output ONLY the Cypher query. No explanations, no introductory text, no markdown. Just the query.
Schema:
{schema}
Question: {question}
Cypher Query:"""
cypher_prompt = PromptTemplate.from_template(CYPHER_GENERATION_TEMPLATE)
# For the QA part, the default prompt is often okay, but you might want to customize it too.
# Here's an example if you choose to:
# QA_TEMPLATE = """You are an assistant that answers questions based on query results from a graph database.
# Use the provided query result to answer the question.
# If the result is empty or does not contain the answer, say so.
# Do not make up information.
# Question: {question}
# Cypher Query Result: {context}
# Answer:"""
# qa_prompt = PromptTemplate.from_template(QA_TEMPLATE)
chain = GraphCypherQAChain.from_llm(
llm=llm,
graph=graph,
verbose=True,
return_intermediate_steps=True,
cypher_prompt=cypher_prompt,
# qa_prompt=qa_prompt # Uncomment if you want to use a custom QA prompt
)
print("LangChain integration with GraphCypherQAChain initialized successfully.")
else:
# This case is now handled by the llm_initialization_error check in process_query
pass
except Exception as e_graph:
graph_connection_error_message = f"Error setting up Neo4j connection: {str(e_graph)}\n"
graph_connection_error_message += "Full Traceback:\n" + traceback.format_exc()
print(graph_connection_error_message)
graph_connection_error = graph_connection_error_message
chain = None
# --- Gradio Interface Function ---
def process_query(message: str, history: list):
if graph_connection_error:
return f"Application Initialization Error (Neo4j): {graph_connection_error}"
if llm_initialization_error:
return f"Application Initialization Error (LLM): {llm_initialization_error}"
if not chain:
return "Error: LangChain QA Chain is not available. Please check server logs for initialization issues."
print(f"Processing message: {message}")
try:
result = chain.invoke({"query": message})
print(f"Chain result: {result}")
answer = result.get("result", "No answer found or an error occurred in processing.")
intermediate_steps = result.get("intermediate_steps", [])
generated_cypher = "Could not extract Cypher query from intermediate steps."
if intermediate_steps and isinstance(intermediate_steps, list) and len(intermediate_steps) > 0:
if isinstance(intermediate_steps[0], dict) and "query" in intermediate_steps[0]:
generated_cypher = intermediate_steps[0]["query"]
# Sometimes the Cypher query might be in a different structure or a later step
# depending on the chain's verbosity and internal structure.
# You might need to inspect intermediate_steps more closely if the above doesn't work.
return f"πŸ“ Generated Cypher:\n```cypher\n{generated_cypher}\n```\n\nπŸ’¬ Answer:\n{answer}"
except Exception as e:
error_message = f"Error processing query: {str(e)}"
print(error_message)
print(traceback.format_exc())
# Specific error check for Hugging Face model issues (e.g. out of memory)
if "CUDA out of memory" in str(e):
return "LLM Error: CUDA out of memory. The model may be too large for your GPU. Try a smaller model or reduce batch size if applicable."
return error_message
# --- Gradio Interface Definition ---
print("Setting up Gradio interface...")
demo = gr.ChatInterface(
fn=process_query,
chatbot=gr.Chatbot(height=600, type="messages"),
title="Neo4j Graph Database Assistant (with Hugging Face LLM)",
description="Ask questions about your Neo4j database. Model responses depend on the chosen Hugging Face LLM.",
examples=[
"How many nodes are in the database?",
"What types of nodes exist?",
"List all relationship types.",
],
theme=gr.themes.Soft(),
cache_examples=False
)
# --- Main Execution ---
if __name__ == "__main__":
print("Launching Gradio interface...")
# To make accessible on the network (e.g., in Docker):
# demo.launch(server_name="0.0.0.0")
demo.launch()