From 20e6bbca5fc40d44e263fac1fe7b1320b1b8acd7 Mon Sep 17 00:00:00 2001 From: seyeong-han Date: Sat, 30 Nov 2024 14:38:56 -0600 Subject: [PATCH 1/3] init: copy codes from original BookMind repo --- examples/bookmind_app/example.env | 1 + examples/bookmind_app/package.json | 48 +++ examples/bookmind_app/public/favicon.ico | Bin 0 -> 3870 bytes examples/bookmind_app/public/index.html | 43 +++ examples/bookmind_app/public/logo192.png | Bin 0 -> 5347 bytes examples/bookmind_app/public/logo512.png | Bin 0 -> 9664 bytes examples/bookmind_app/public/manifest.json | 25 ++ examples/bookmind_app/public/robots.txt | 3 + examples/bookmind_app/server/README.md | 27 ++ examples/bookmind_app/server/example.env | 3 + examples/bookmind_app/server/requirements.txt | 5 + examples/bookmind_app/server/server.py | 276 ++++++++++++++++++ examples/bookmind_app/server/test.py | 0 examples/bookmind_app/src/App.css | 38 +++ examples/bookmind_app/src/App.js | 17 ++ examples/bookmind_app/src/App.test.js | 8 + examples/bookmind_app/src/approuter.jsx | 26 ++ examples/bookmind_app/src/index.css | 3 + examples/bookmind_app/src/index.js | 13 + examples/bookmind_app/src/logo.svg | 1 + examples/bookmind_app/src/pages/Layout.jsx | 19 ++ .../bookmind_app/src/pages/MindMap/index.jsx | 127 ++++++++ .../pages/bookPage/components/AISearch.jsx | 71 +++++ .../bookPage/components/CharacterGraph.jsx | 73 +++++ .../bookPage/components/ErrorBoundary.jsx | 29 ++ .../bookmind_app/src/pages/bookPage/index.jsx | 233 +++++++++++++++ .../pages/homePage/components/Features.jsx | 78 +++++ .../src/pages/homePage/components/Hero.jsx | 53 ++++ .../pages/homePage/components/HowItWorks.jsx | 89 ++++++ .../bookmind_app/src/pages/homePage/index.jsx | 13 + .../searchTestPage/GraphVisualization.jsx | 54 ++++ .../pages/searchTestPage/InitializeMemory.jsx | 40 +++ .../src/pages/searchTestPage/QueryMemory.jsx | 41 +++ .../src/pages/searchTestPage/index.jsx | 21 ++ examples/bookmind_app/src/reportWebVitals.js | 13 + examples/bookmind_app/src/setupTests.js | 5 + examples/bookmind_app/tailwind.config.js | 23 ++ 37 files changed, 1519 insertions(+) create mode 100644 examples/bookmind_app/example.env create mode 100644 examples/bookmind_app/package.json create mode 100644 examples/bookmind_app/public/favicon.ico create mode 100644 examples/bookmind_app/public/index.html create mode 100644 examples/bookmind_app/public/logo192.png create mode 100644 examples/bookmind_app/public/logo512.png create mode 100644 examples/bookmind_app/public/manifest.json create mode 100644 examples/bookmind_app/public/robots.txt create mode 100644 examples/bookmind_app/server/README.md create mode 100644 examples/bookmind_app/server/example.env create mode 100644 examples/bookmind_app/server/requirements.txt create mode 100644 examples/bookmind_app/server/server.py create mode 100644 examples/bookmind_app/server/test.py create mode 100644 examples/bookmind_app/src/App.css create mode 100644 examples/bookmind_app/src/App.js create mode 100644 examples/bookmind_app/src/App.test.js create mode 100644 examples/bookmind_app/src/approuter.jsx create mode 100644 examples/bookmind_app/src/index.css create mode 100644 examples/bookmind_app/src/index.js create mode 100644 examples/bookmind_app/src/logo.svg create mode 100644 examples/bookmind_app/src/pages/Layout.jsx create mode 100644 examples/bookmind_app/src/pages/MindMap/index.jsx create mode 100644 examples/bookmind_app/src/pages/bookPage/components/AISearch.jsx create mode 100644 examples/bookmind_app/src/pages/bookPage/components/CharacterGraph.jsx create mode 100644 examples/bookmind_app/src/pages/bookPage/components/ErrorBoundary.jsx create mode 100644 examples/bookmind_app/src/pages/bookPage/index.jsx create mode 100644 examples/bookmind_app/src/pages/homePage/components/Features.jsx create mode 100644 examples/bookmind_app/src/pages/homePage/components/Hero.jsx create mode 100644 examples/bookmind_app/src/pages/homePage/components/HowItWorks.jsx create mode 100644 examples/bookmind_app/src/pages/homePage/index.jsx create mode 100644 examples/bookmind_app/src/pages/searchTestPage/GraphVisualization.jsx create mode 100644 examples/bookmind_app/src/pages/searchTestPage/InitializeMemory.jsx create mode 100644 examples/bookmind_app/src/pages/searchTestPage/QueryMemory.jsx create mode 100644 examples/bookmind_app/src/pages/searchTestPage/index.jsx create mode 100644 examples/bookmind_app/src/reportWebVitals.js create mode 100644 examples/bookmind_app/src/setupTests.js create mode 100644 examples/bookmind_app/tailwind.config.js diff --git a/examples/bookmind_app/example.env b/examples/bookmind_app/example.env new file mode 100644 index 000000000..41d80c076 --- /dev/null +++ b/examples/bookmind_app/example.env @@ -0,0 +1 @@ +REACT_APP_GOOGLE_BOOKS_API_KEY={YOUR_API_KEY} \ No newline at end of file diff --git a/examples/bookmind_app/package.json b/examples/bookmind_app/package.json new file mode 100644 index 000000000..ec233d2bb --- /dev/null +++ b/examples/bookmind_app/package.json @@ -0,0 +1,48 @@ +{ + "name": "bookmind", + "version": "0.1.0", + "private": true, + "dependencies": { + "@testing-library/jest-dom": "^5.17.0", + "@testing-library/react": "^13.4.0", + "@testing-library/user-event": "^13.5.0", + "axios": "^1.7.7", + "fs": "^0.0.1-security", + "lottie-react": "^2.4.0", + "lucide-react": "^0.460.0", + "react": "^18.3.1", + "react-dom": "^18.3.1", + "react-force-graph": "^1.44.7", + "react-force-graph-2d": "^1.25.8", + "react-router-dom": "^7.0.1", + "react-scripts": "^5.0.1", + "web-vitals": "^2.1.4" + }, + "scripts": { + "start": "react-scripts start", + "build": "react-scripts build", + "test": "react-scripts test", + "eject": "react-scripts eject" + }, + "eslintConfig": { + "extends": [ + "react-app", + "react-app/jest" + ] + }, + "browserslist": { + "production": [ + ">0.2%", + "not dead", + "not op_mini all" + ], + "development": [ + "last 1 chrome version", + "last 1 firefox version", + "last 1 safari version" + ] + }, + "devDependencies": { + "tailwindcss": "^3.4.15" + } +} diff --git a/examples/bookmind_app/public/favicon.ico b/examples/bookmind_app/public/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..a11777cc471a4344702741ab1c8a588998b1311a GIT binary patch literal 3870 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 baj7?x%VD!5Cxk2YbYLNVeiXvvpMCWYo=by@ literal 0 HcmV?d00001 diff --git a/examples/bookmind_app/public/index.html b/examples/bookmind_app/public/index.html new file mode 100644 index 000000000..aa069f27c --- /dev/null +++ b/examples/bookmind_app/public/index.html @@ -0,0 +1,43 @@ + + + + + + + + + + + + + React App + + + +
+ + + diff --git a/examples/bookmind_app/public/logo192.png b/examples/bookmind_app/public/logo192.png new file mode 100644 index 0000000000000000000000000000000000000000..fc44b0a3796c0e0a64c3d858ca038bd4570465d9 GIT binary patch literal 5347 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 b{|{}U^kRn2wo}j7|0ATu<;8xA7zX}7|B6mN literal 0 HcmV?d00001 diff --git a/examples/bookmind_app/public/manifest.json b/examples/bookmind_app/public/manifest.json new file mode 100644 index 000000000..080d6c77a --- /dev/null +++ b/examples/bookmind_app/public/manifest.json @@ -0,0 +1,25 @@ +{ + "short_name": "React App", + "name": "Create React App Sample", + "icons": [ + { + "src": "favicon.ico", + "sizes": "64x64 32x32 24x24 16x16", + "type": "image/x-icon" + }, + { + "src": "logo192.png", + "type": "image/png", + "sizes": "192x192" + }, + { + "src": "logo512.png", + "type": "image/png", + "sizes": "512x512" + } + ], + "start_url": ".", + "display": "standalone", + "theme_color": "#000000", + "background_color": "#ffffff" +} diff --git a/examples/bookmind_app/public/robots.txt b/examples/bookmind_app/public/robots.txt new file mode 100644 index 000000000..e9e57dc4d --- /dev/null +++ b/examples/bookmind_app/public/robots.txt @@ -0,0 +1,3 @@ +# https://www.robotstxt.org/robotstxt.html +User-agent: * +Disallow: diff --git a/examples/bookmind_app/server/README.md b/examples/bookmind_app/server/README.md new file mode 100644 index 000000000..15c62a8e1 --- /dev/null +++ b/examples/bookmind_app/server/README.md @@ -0,0 +1,27 @@ +# Book Character Graph API + +A Flask-based API server that analyzes books to create character relationship graphs and provides an interactive query interface using LlamaStack. + +## Features + +- Character and relationship extraction from books +- Graph generation of character relationships +- Memory-based query system for book details +- Interactive Q&A about book characters and plots + +## Prerequisites + +- Python 3.x +- LlamaStack server running locally +- Environment variables: + - `LLAMA_STACK_PORT` + - `INFERENCE_MODEL` + +## Get Started + +```bash +# Install dependencies +pip install -r requirements.txt + +python server.py +``` diff --git a/examples/bookmind_app/server/example.env b/examples/bookmind_app/server/example.env new file mode 100644 index 000000000..ebf82724c --- /dev/null +++ b/examples/bookmind_app/server/example.env @@ -0,0 +1,3 @@ +LLAMA_STACK_PORT=5000 +INFERENCE_MODEL="meta-llama/Llama-3.2-3B-Instruct" +SERVER_PORT=5001 \ No newline at end of file diff --git a/examples/bookmind_app/server/requirements.txt b/examples/bookmind_app/server/requirements.txt new file mode 100644 index 000000000..fdbf142b4 --- /dev/null +++ b/examples/bookmind_app/server/requirements.txt @@ -0,0 +1,5 @@ +flask +flask-cors +llama_stack_client +asyncio +werkzeug \ No newline at end of file diff --git a/examples/bookmind_app/server/server.py b/examples/bookmind_app/server/server.py new file mode 100644 index 000000000..830a2b691 --- /dev/null +++ b/examples/bookmind_app/server/server.py @@ -0,0 +1,276 @@ +import os +import json +import asyncio +import logging +from flask import Flask, request, jsonify +from flask_cors import CORS +from llama_stack_client import LlamaStackClient +from llama_stack_client.lib.agents.agent import Agent +from llama_stack_client.lib.agents.event_logger import EventLogger +from llama_stack_client.types.agent_create_params import AgentConfig + +# Flask setup +app = Flask(__name__) +CORS(app) + +# Memory initialization +active_sessions = {} + + +@app.route("/initialize", methods=["POST"]) +def initialize_memory(): + """ + Initialize memory for a new book. Queries LlamaStack for characters and relationships, + and sets up memory for the user to interact with. + """ + data = request.json + book_title = data.get("title") + if not book_title: + return jsonify({"error": "Book title is required"}), 400 + + # Clear the previous session if any + active_sessions.clear() + + # Create a new memory agent and process the book + response = asyncio.run(process_book(book_title)) + return jsonify(response), 200 + + +async def async_generator_wrapper(sync_gen): + for item in sync_gen: + yield item + + +async def get_graph_response(text_response, client): + # Create prompt for graph conversion + graph_prompt = f""" + Convert this character description into a graph format with nodes and links. + Format the response as a JSON object with "nodes" and "links" arrays. + Each node should have "id", "name", and "val" properties. + Each link should have "source" and "target" properties using the node ids. + Set all node "val" to 10. + + Text to convert: + {text_response} + + Expected format example (return only the JSON object, no additional text): + {{ + "nodes": [ + {{"id": id1, "name": "Character Name", "val": 10}} + ], + "links": [ + {{"source": id1, "target": "id2"}} + ] + }} + id1 and id2 are example variables and you should not generate those exact values. + """ + + # Get graph structure from LlamaStack + graph_response = client.inference.chat_completion( + model_id=os.environ["INFERENCE_MODEL"], + messages=[ + {"role": "system", "content": "You are a data structure expert. Convert text descriptions into graph JSON format."}, + {"role": "user", "content": graph_prompt} + ] + ) + return graph_response + + +def jsonify_graph_response(response): + """Extract and parse JSON content from graph response.""" + try: + content = response.completion_message.content + print("content: ", content) + # Find indices of first { and last } + start_idx = content.find('{') + end_idx = content.rfind('}') + + if start_idx == -1 or end_idx == -1: + raise ValueError("No valid JSON object found in response") + + # Extract JSON string + json_str = content[start_idx:end_idx + 1] + + # Parse JSON + return json.loads(json_str) + + except Exception as e: + logging.error(f"Error parsing graph response: {e}") + return None + + +async def process_book(book_title): + """ + Process the book title, query LlamaStack for characters and relationships, + and initialize memory. + """ + client = LlamaStackClient(base_url=f"http://localhost:{os.environ['LLAMA_STACK_PORT']}") + agent_config = AgentConfig( + model=os.environ["INFERENCE_MODEL"], + instructions="You are a helpful assistant", + tools=[{"type": "memory"}], # Enable memory + enable_session_persistence=True, + max_infer_iters=5, + ) + + # Create the agent and session + agent = Agent(client, agent_config) + session_id = agent.create_session(f"{book_title}-session") + active_sessions["agent"] = agent + active_sessions["session_id"] = session_id + logging.info(f"Created session_id={session_id} for book: {book_title}") + + # Query LlamaStack for characters and relationships + prompt = f"Who are the characters in the book '{book_title}', and what are their relationships?" + + response = client.inference.chat_completion( + model_id=os.environ["INFERENCE_MODEL"], + messages=[ + {"role": "system", "content": "You are a knowledgeable book expert. Provide detailed information about characters and their relationships in the book."}, + {"role": "user", "content": prompt} + ] + ) + text_response = response.completion_message.content + + file_name = f"{book_title.replace(' ', '_').lower()}_memory.txt" + with open(file_name, "w") as f: + f.write(text_response) + + graph_response = await get_graph_response(text_response, client) + + print("graph_response: ", graph_response) + + graph_data = "" + try: + graph_data = jsonify_graph_response(graph_response) + logging.info("Graph data generated:", json.dumps(graph_data, indent=2)) + except json.JSONDecodeError as e: + logging.error(f"Error parsing graph response: {e}") + + # Push to memory agent (optional if further memory setup is needed) + memory_prompt = "Save this knowledge about the book into memory for future questions." + memory_response = agent.create_turn( + messages=[{"role": "user", "content": memory_prompt}], + attachments=[ + {"content": text_response, "mime_type": "text/plain"} + ], + session_id=session_id, + ) + + async for log in async_generator_wrapper(EventLogger().log(memory_response)): + log.print() + + return graph_data + + +def convert_to_graph_format(entities, relationships): + """ + Converts entities and relationships into a graph dictionary format. + """ + nodes = [] + links = [] + node_id_map = {} + node_counter = 1 + + # Add entities as nodes + for entity in entities: + name = entity["text"] + if name not in node_id_map: + node_id_map[name] = f"id{node_counter}" + nodes.append({"id": f"id{node_counter}", "name": name, "val": 10}) + node_counter += 1 + + # Add relationships as links + for relationship in relationships.split("\n"): # Assuming relationships are line-separated + parts = relationship.split(" and ") + if len(parts) == 2: + source_name = parts[0].strip() + target_name = parts[1].split(" are")[0].strip() + + if source_name in node_id_map and target_name in node_id_map: + links.append({ + "source": node_id_map[source_name], + "target": node_id_map[target_name] + }) + + return {"nodes": nodes, "links": links} + + +def convert_to_graph_format_old(response): + """ + Converts LlamaStack's text response into a graph dictionary format. + """ + nodes = [] + links = [] + + # Simplified parsing logic (replace with actual NLP or regex parsing) + lines = [line for line in response if line.strip()] + node_id_map = {} + node_counter = 1 + + for line in lines: + if " and " in line: # Assumes relationships are described as "X and Y are friends" + parts = line.split(" and ") + if len(parts) == 2: + source_name = parts[0].strip() + target_name = parts[1].split(" are")[0].strip() + + # Add nodes if they don't already exist + for name in [source_name, target_name]: + if name not in node_id_map: + node_id_map[name] = f"id{node_counter}" + nodes.append({"id": f"id{node_counter}", "name": name, "val": 10}) + node_counter += 1 + + # Add the relationship as a link + links.append({ + "source": node_id_map[source_name], + "target": node_id_map[target_name] + }) + + return {"nodes": nodes, "links": links} + + +@app.route("/query", methods=["POST"]) +def query_memory(): + """ + Handles user queries and returns answers based on memory. + """ + data = request.json + query = data.get("query") + if not query: + return jsonify({"error": "Query parameter is missing"}), 400 + + # Query the memory agent + response = asyncio.run(query_llama_stack(query)) + return jsonify({"response": response}) + + +async def query_llama_stack(prompt): + """ + Queries the active LlamaStack session with a user prompt. + """ + if "agent" not in active_sessions: + return "No active agent session. Please initialize a book first." + + agent = active_sessions["agent"] + session_id = active_sessions["session_id"] + + response = agent.create_turn( + messages=[{"role": "user", "content": prompt}], + session_id=session_id, + ) + + # Process response logs + result = [] + async for log in async_generator_wrapper(EventLogger().log(response)): + result.append(str(log)) + + inference_start_idx = result.index("inference> ") + inference_logs = result[inference_start_idx + 1:] + + return "\n".join(inference_logs) + + +if __name__ == "__main__": + app.run(debug=True, port=5001) diff --git a/examples/bookmind_app/server/test.py b/examples/bookmind_app/server/test.py new file mode 100644 index 000000000..e69de29bb diff --git a/examples/bookmind_app/src/App.css b/examples/bookmind_app/src/App.css new file mode 100644 index 000000000..74b5e0534 --- /dev/null +++ b/examples/bookmind_app/src/App.css @@ -0,0 +1,38 @@ +.App { + text-align: center; +} + +.App-logo { + height: 40vmin; + pointer-events: none; +} + +@media (prefers-reduced-motion: no-preference) { + .App-logo { + animation: App-logo-spin infinite 20s linear; + } +} + +.App-header { + background-color: #282c34; + min-height: 100vh; + display: flex; + flex-direction: column; + align-items: center; + justify-content: center; + font-size: calc(10px + 2vmin); + color: white; +} + +.App-link { + color: #61dafb; +} + +@keyframes App-logo-spin { + from { + transform: rotate(0deg); + } + to { + transform: rotate(360deg); + } +} diff --git a/examples/bookmind_app/src/App.js b/examples/bookmind_app/src/App.js new file mode 100644 index 000000000..d3271465c --- /dev/null +++ b/examples/bookmind_app/src/App.js @@ -0,0 +1,17 @@ +import { BrowserRouter as Router, Routes, Route } from "react-router-dom"; +import Home from "./homePage/index"; +import SearchPage from "./bookPage/components/SearchPage"; + +function App() { + return ( + + + {/* Define routes for Home and SearchPage */} + } /> + } /> + + + ); +} + +export default App; diff --git a/examples/bookmind_app/src/App.test.js b/examples/bookmind_app/src/App.test.js new file mode 100644 index 000000000..1f03afeec --- /dev/null +++ b/examples/bookmind_app/src/App.test.js @@ -0,0 +1,8 @@ +import { render, screen } from '@testing-library/react'; +import App from './App'; + +test('renders learn react link', () => { + render(); + const linkElement = screen.getByText(/learn react/i); + expect(linkElement).toBeInTheDocument(); +}); diff --git a/examples/bookmind_app/src/approuter.jsx b/examples/bookmind_app/src/approuter.jsx new file mode 100644 index 000000000..7a80f93cf --- /dev/null +++ b/examples/bookmind_app/src/approuter.jsx @@ -0,0 +1,26 @@ +/* eslint-disable no-extra-semi */ +/* eslint-disable react/prop-types */ +/* eslint-disable no-unused-vars */ +import { Route, BrowserRouter as Router, Routes } from "react-router-dom"; + +import Home from "./pages/homePage"; +import BookPage from "./pages/bookPage"; + +const AppRouter = function () { + return ( + <> + + } /> + } /> + + + ); +}; + +const App = () => ( + + + +); + +export default App; diff --git a/examples/bookmind_app/src/index.css b/examples/bookmind_app/src/index.css new file mode 100644 index 000000000..b5c61c956 --- /dev/null +++ b/examples/bookmind_app/src/index.css @@ -0,0 +1,3 @@ +@tailwind base; +@tailwind components; +@tailwind utilities; diff --git a/examples/bookmind_app/src/index.js b/examples/bookmind_app/src/index.js new file mode 100644 index 000000000..6e917b174 --- /dev/null +++ b/examples/bookmind_app/src/index.js @@ -0,0 +1,13 @@ +import React from "react"; +import ReactDOM from "react-dom/client"; +import "./index.css"; +import AppRouter from "./approuter"; +import reportWebVitals from "./reportWebVitals"; + +const root = ReactDOM.createRoot(document.getElementById("root")); +root.render(); + +// If you want to start measuring performance in your app, pass a function +// to log results (for example: reportWebVitals(console.log)) +// or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals +reportWebVitals(); diff --git a/examples/bookmind_app/src/logo.svg b/examples/bookmind_app/src/logo.svg new file mode 100644 index 000000000..9dfc1c058 --- /dev/null +++ b/examples/bookmind_app/src/logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/examples/bookmind_app/src/pages/Layout.jsx b/examples/bookmind_app/src/pages/Layout.jsx new file mode 100644 index 000000000..da6868d42 --- /dev/null +++ b/examples/bookmind_app/src/pages/Layout.jsx @@ -0,0 +1,19 @@ +import "../index.css"; + +export const metadata = { + title: "BookMind - Unravel Stories, One Map at a Time", + description: + "Explore character relationships and storylines with AI-powered visualizations.", +}; + +export default function RootLayout({ children }) { + return ( + + + {metadata.title} + + + {children} + + ); +} diff --git a/examples/bookmind_app/src/pages/MindMap/index.jsx b/examples/bookmind_app/src/pages/MindMap/index.jsx new file mode 100644 index 000000000..a621fc396 --- /dev/null +++ b/examples/bookmind_app/src/pages/MindMap/index.jsx @@ -0,0 +1,127 @@ +import React, { useState } from "react"; +import CytoscapeComponent from "react-cytoscapejs"; + +const MindMap = () => { + const [hoveredNode, setHoveredNode] = useState(null); + + // Graph data: Nodes and Edges + const elements = [ + { data: { id: "Harry", label: "Harry Potter" } }, + { data: { id: "Hermione", label: "Hermione Granger" } }, + { data: { id: "Ron", label: "Ron Weasley" } }, + { data: { id: "Dumbledore", label: "Albus Dumbledore" } }, + { + data: { + id: "friendship1", + source: "Harry", + target: "Hermione", + label: "Friends", + }, + }, + { + data: { + id: "friendship2", + source: "Harry", + target: "Ron", + label: "Best Friends", + }, + }, + { + data: { + id: "mentor", + source: "Dumbledore", + target: "Harry", + label: "Mentor", + }, + }, + ]; + + // Cytoscape Styles for Nodes and Edges + const style = [ + { + selector: "node", + style: { + "background-color": "#0074D9", + label: "data(label)", + "text-valign": "center", + "text-halign": "center", + color: "#ffffff", + "font-size": "10px", + width: "40px", + height: "40px", + }, + }, + { + selector: "edge", + style: { + "line-color": "#AAAAAA", + "target-arrow-color": "#AAAAAA", + "target-arrow-shape": "triangle", + "curve-style": "bezier", + label: "data(label)", + "font-size": "8px", + color: "#333333", + "text-outline-color": "#ffffff", + "text-outline-width": "1px", + }, + }, + { + selector: ":selected", + style: { + "background-color": "#FF4136", + "line-color": "#FF4136", + "target-arrow-color": "#FF4136", + "source-arrow-color": "#FF4136", + }, + }, + ]; + + // Handle hover events + const handleMouseOver = (event) => { + const node = event.target.data(); + setHoveredNode(node); + }; + + const handleMouseOut = () => { + setHoveredNode(null); + }; + + return ( +
+
+ { + // Add event listeners for hover + cy.on("mouseover", "node", handleMouseOver); + cy.on("mouseout", "node", handleMouseOut); + }} + /> +
+ {hoveredNode && ( +
+ Node Details: +

ID: {hoveredNode.id}

+

Label: {hoveredNode.label}

+
+ )} +
+ ); +}; + +export default MindMap; diff --git a/examples/bookmind_app/src/pages/bookPage/components/AISearch.jsx b/examples/bookmind_app/src/pages/bookPage/components/AISearch.jsx new file mode 100644 index 000000000..042198b92 --- /dev/null +++ b/examples/bookmind_app/src/pages/bookPage/components/AISearch.jsx @@ -0,0 +1,71 @@ +import { useState } from "react"; +import { FaSearch, FaSpinner } from "react-icons/fa"; +import axios from "axios"; + +export default function AISearch({ bookTitle, onQueryResponse }) { + const [query, setQuery] = useState(""); + const [response, setResponse] = useState(""); + const [isLoading, setIsLoading] = useState(false); + const [error, setError] = useState(null); + + const handleSearch = async () => { + if (!query.trim()) return; + + setIsLoading(true); + setError(null); + + try { + const response = await axios.post("http://localhost:5001/query", { + query: `About ${bookTitle}: ${query}`, + }); + + setResponse(response.data.response); + onQueryResponse?.(response.data); + } catch (error) { + console.error("Error in AI search:", error); + setError("Failed to get response. Please try again."); + } finally { + setIsLoading(false); + } + }; + + return ( +
+

AI-Powered Search

+
+ setQuery(e.target.value)} + className="w-full px-4 py-2 rounded-md border-gray-300 + focus:border-blue-500 focus:ring focus:ring-blue-200 + transition duration-200" + disabled={isLoading} + /> + +
+ + {error && ( +
{error}
+ )} + + {response && !error && ( +
+

AI Response:

+

{response}

+
+ )} +
+ ); +} diff --git a/examples/bookmind_app/src/pages/bookPage/components/CharacterGraph.jsx b/examples/bookmind_app/src/pages/bookPage/components/CharacterGraph.jsx new file mode 100644 index 000000000..09578b526 --- /dev/null +++ b/examples/bookmind_app/src/pages/bookPage/components/CharacterGraph.jsx @@ -0,0 +1,73 @@ +import { useState, useEffect, useRef } from "react"; +import ForceGraph2D from "react-force-graph-2d"; + +export default function CharacterGraph({ graphData }) { + const containerRef = useRef(null); + const [dimensions, setDimensions] = useState({ width: 300, height: 300 }); + + useEffect(() => { + const updateDimensions = () => { + if (containerRef.current) { + setDimensions({ + width: containerRef.current.offsetWidth, + height: Math.max(300, containerRef.current.offsetHeight), + }); + } + }; + + updateDimensions(); + window.addEventListener("resize", updateDimensions); + return () => window.removeEventListener("resize", updateDimensions); + }, []); + + return ( +
+

+ Character Relationship Graph +

+
+ { + const label = node.name; + const fontSize = 12 / globalScale; + ctx.font = `${fontSize}px Arial`; + const textWidth = ctx.measureText(label).width; + const bckgDimensions = [textWidth, fontSize].map( + (n) => n + fontSize * 0.2 + ); + + ctx.fillStyle = "rgba(255, 255, 255, 0.8)"; + ctx.fillRect( + node.x - bckgDimensions[0] / 2, + node.y - bckgDimensions[1] / 2, + ...bckgDimensions + ); + + ctx.textAlign = "center"; + ctx.textBaseline = "middle"; + ctx.fillStyle = "#3b82f6"; + ctx.fillText(label, node.x, node.y); + + node.__bckgDimensions = bckgDimensions; + }} + nodePointerAreaPaint={(node, color, ctx) => { + ctx.fillStyle = color; + const bckgDimensions = node.__bckgDimensions; + bckgDimensions && + ctx.fillRect( + node.x - bckgDimensions[0] / 2, + node.y - bckgDimensions[1] / 2, + ...bckgDimensions + ); + }} + linkColor={() => "#9ca3af"} + linkWidth={1} + backgroundColor="#ffffff" + width={dimensions.width} + height={dimensions.height} + /> +
+
+ ); +} diff --git a/examples/bookmind_app/src/pages/bookPage/components/ErrorBoundary.jsx b/examples/bookmind_app/src/pages/bookPage/components/ErrorBoundary.jsx new file mode 100644 index 000000000..a88032894 --- /dev/null +++ b/examples/bookmind_app/src/pages/bookPage/components/ErrorBoundary.jsx @@ -0,0 +1,29 @@ +'use client' + +import { Component } from 'react' + +class ErrorBoundary extends Component { + constructor(props) { + super(props) + this.state = { hasError: false } + } + + static getDerivedStateFromError(error) { + return { hasError: true } + } + + componentDidCatch(error, errorInfo) { + console.log('ErrorBoundary caught an error:', error, errorInfo) + } + + render() { + if (this.state.hasError) { + return

Something went wrong.

+ } + + return this.props.children + } +} + +export default ErrorBoundary + diff --git a/examples/bookmind_app/src/pages/bookPage/index.jsx b/examples/bookmind_app/src/pages/bookPage/index.jsx new file mode 100644 index 000000000..9e3b9f88d --- /dev/null +++ b/examples/bookmind_app/src/pages/bookPage/index.jsx @@ -0,0 +1,233 @@ +import React, { useState } from "react"; +import { FaSearch, FaBook, FaHome } from "react-icons/fa"; +import { Link } from "react-router-dom"; +import AISearch from "./components/AISearch"; +import CharacterGraph from "./components/CharacterGraph"; +import axios from "axios"; + +export default function BookPage() { + const [searchTerm, setSearchTerm] = useState(""); + const [isLoading, setIsLoading] = useState(false); + const [graphData, setGraphData] = useState(null); + const [bookData, setBookData] = useState(null); + const [searchComplete, setSearchComplete] = useState(false); + + const verificationGraphData = (graphData) => { + try { + // Create Set of valid node IDs + const nodeIds = new Set(graphData.nodes.map((node) => node.id)); + + // Filter links to only include valid node references + const validLinks = graphData.links.filter( + (link) => nodeIds.has(link.source) && nodeIds.has(link.target) + ); + + return { + nodes: graphData.nodes, + links: validLinks, + }; + } catch (error) { + console.error("Error validating graph data:", error); + return graphData; // Return original data if validation fails + } + }; + + const initializeMemory = async (title) => { + setIsLoading(true); + try { + const response = await axios.post("http://localhost:5001/initialize", { + title: title, + }); + + // Verify and set graph data + const verifiedData = verificationGraphData(response.data); + setGraphData(verifiedData); + + return verifiedData; + } catch (error) { + console.error("Initialization error:", error); + throw error; + } finally { + setIsLoading(false); + } + }; + + const handleSubmit = async (e) => { + e.preventDefault(); + if (!searchTerm.trim()) { + return; + } + + setIsLoading(true); + try { + // Initialize memory and fetch book data in parallel + const [memoryResponse, bookInfo] = await Promise.all([ + initializeMemory(searchTerm), + fetchBookData(searchTerm), + ]); + + setBookData({ + title: bookInfo.title, + subtitle: bookInfo.summary, + posterUrl: bookInfo.coverUrl, + author: bookInfo.author, + publishedDate: bookInfo.publishedDate, + pageCount: bookInfo.pageCount, + }); + + setGraphData(memoryResponse); + setSearchComplete(true); + } catch (error) { + console.error("Search error:", error); + } finally { + setIsLoading(false); + } + }; + // Add new function to fetch book cover + const fetchBookData = async (bookTitle) => { + try { + const response = await axios.get( + `https://www.googleapis.com/books/v1/volumes`, + { + params: { + q: bookTitle, + key: process.env.REACT_APP_GOOGLE_BOOKS_API_KEY, + }, + } + ); + + if (response.data.items && response.data.items[0]) { + const volumeInfo = response.data.items[0].volumeInfo; + const imageLinks = volumeInfo.imageLinks || {}; + + return { + coverUrl: + imageLinks.extraLarge || + imageLinks.large || + imageLinks.medium || + imageLinks.thumbnail || + "/placeholder.jpg", + summary: volumeInfo.description || "No summary available", + title: volumeInfo.title, + author: volumeInfo.authors?.[0] || "Unknown Author", + publishedDate: volumeInfo.publishedDate, + pageCount: volumeInfo.pageCount, + }; + } + + return { + coverUrl: "/placeholder.jpg", + summary: "No summary available", + title: bookTitle, + author: "Unknown Author", + publishedDate: "", + pageCount: 0, + }; + } catch (error) { + console.error("Error fetching book data:", error); + return { + coverUrl: "/placeholder.jpg", + summary: "Failed to load book information", + title: bookTitle, + author: "Unknown Author", + publishedDate: "", + pageCount: 0, + }; + } + }; + + return ( +
+
+ {/* Home Button */} +
+ + + Home + +
+ + {/* Search Section */} +
+

+ + Character Mind Map + +

+
+
+
+ setSearchTerm(e.target.value)} + placeholder="Enter book or movie title..." + className="w-full px-5 py-3 rounded-lg border-2 border-gray-200 + focus:border-blue-500 focus:ring-2 focus:ring-blue-200 + transition-all duration-200 bg-white/90 + placeholder-gray-400 text-gray-700" + disabled={isLoading} + /> +
+ +
+
+

+ Search for any book or movie to explore character relationships +

+
+ + {/* Info Section - Only show when search is complete */} + {searchComplete && bookData && ( +
+
+
+
+ {bookData.title} +
+
+
+ +

+ {bookData.title} +

+
+

{bookData.subtitle}

+
+
+
+ +
+
+ +
+
+ +
+
+
+ )} +
+
+ ); +} diff --git a/examples/bookmind_app/src/pages/homePage/components/Features.jsx b/examples/bookmind_app/src/pages/homePage/components/Features.jsx new file mode 100644 index 000000000..a9eb2ec0a --- /dev/null +++ b/examples/bookmind_app/src/pages/homePage/components/Features.jsx @@ -0,0 +1,78 @@ +import { BookOpen, MessageSquare, FileText, Users } from "lucide-react"; + +const features = [ + { + icon: BookOpen, + title: "Interactive Mind Maps", + description: + "Visualize relationships between characters and plot elements.", + }, + { + icon: MessageSquare, + title: "AI Chatbot", + description: + "Ask deep questions about the book and get insightful answers.", + }, + { + icon: FileText, + title: "Book Summaries", + description: "Get concise overviews of plots and themes.", + }, + { + icon: Users, + title: "Community Contributions", + description: "Add and refine maps with fellow book lovers.", + }, +]; + +export default function Features() { + return ( +
+
+
+

+ Key Features +

+

+ Discover the power of AI-driven book analysis +

+
+ +
+ {features.map((feature, index) => ( +
+
+ +

+ {feature.title} +

+

+ {feature.description} +

+
+ ))} +
+
+
+ ); +} diff --git a/examples/bookmind_app/src/pages/homePage/components/Hero.jsx b/examples/bookmind_app/src/pages/homePage/components/Hero.jsx new file mode 100644 index 000000000..17f479eb7 --- /dev/null +++ b/examples/bookmind_app/src/pages/homePage/components/Hero.jsx @@ -0,0 +1,53 @@ +import { useNavigate } from "react-router-dom"; +import { useState, useEffect } from "react"; +import Lottie from "lottie-react"; + +export default function Hero() { + const navigate = useNavigate(); + const [animationData, setAnimationData] = useState(null); + + useEffect(() => { + const fetchAnimationData = async () => { + try { + const response = await fetch( + "https://lottie.host/909e50db-34ef-47ac-8384-db31f6fc0654/e2xX6qZZ7i.json" + ); + const data = await response.json(); + setAnimationData(data); + } catch (error) { + console.error("Error fetching Lottie animation:", error); + } + }; + + fetchAnimationData(); + }, []); + + return ( +
+
+ {animationData && ( + + )} +
+
+
+

+ Unravel Stories
One Map at a Time +

+

+ Explore character relationships and storylines with AI-powered + visualizations. +

+ +
+
+ ); +} diff --git a/examples/bookmind_app/src/pages/homePage/components/HowItWorks.jsx b/examples/bookmind_app/src/pages/homePage/components/HowItWorks.jsx new file mode 100644 index 000000000..ecdbe7810 --- /dev/null +++ b/examples/bookmind_app/src/pages/homePage/components/HowItWorks.jsx @@ -0,0 +1,89 @@ +import { useState, useEffect } from "react"; +import { Brain, Search, MessageSquare } from "lucide-react"; + +const steps = [ + { + icon: Search, + title: "Search for a Book", + description: "Enter the title of the book you want to explore.", + }, + { + icon: Brain, + title: "AI Analysis", + description: "The AI analyzes the book and generates a mind map.", + }, + { + icon: MessageSquare, + title: "Explore Insights", + description: + "Ask questions and explore relationships, themes, and insights.", + }, +]; + +export default function HowItWorks() { + const [activeStep, setActiveStep] = useState(0); + + useEffect(() => { + const interval = setInterval(() => { + setActiveStep((prevStep) => (prevStep + 1) % steps.length); + }, 3000); + return () => clearInterval(interval); + }, []); + + return ( +
+
+
+

+ How It Works +

+

+ Discover the power of AI-driven book analysis +

+
+
+ {steps.map((step, index) => ( +
+
+ +

+ {step.title} +

+

+ {step.description} +

+
+ ))} +
+
+
+ ); +} diff --git a/examples/bookmind_app/src/pages/homePage/index.jsx b/examples/bookmind_app/src/pages/homePage/index.jsx new file mode 100644 index 000000000..aab121236 --- /dev/null +++ b/examples/bookmind_app/src/pages/homePage/index.jsx @@ -0,0 +1,13 @@ +import Hero from "./components/Hero"; +import Features from "./components/Features"; +import HowItWorks from "./components/HowItWorks"; + +export default function Home() { + return ( +
+ + + +
+ ); +} diff --git a/examples/bookmind_app/src/pages/searchTestPage/GraphVisualization.jsx b/examples/bookmind_app/src/pages/searchTestPage/GraphVisualization.jsx new file mode 100644 index 000000000..2590c8497 --- /dev/null +++ b/examples/bookmind_app/src/pages/searchTestPage/GraphVisualization.jsx @@ -0,0 +1,54 @@ +import React from "react"; +import CytoscapeComponent from "react-cytoscapejs"; + +const GraphVisualization = ({ graphData }) => { + const elements = [ + ...graphData.nodes.map((node) => ({ + data: { id: node.id, label: node.name }, + })), + ...graphData.links.map((link) => ({ + data: { source: link.source, target: link.target }, + })), + ]; + + const layout = { name: "circle" }; + + const style = [ + { + selector: "node", + style: { + "background-color": "#0074D9", + label: "data(label)", + "text-valign": "center", + "text-halign": "center", + color: "#fff", + "font-size": "10px", + width: "40px", + height: "40px", + }, + }, + { + selector: "edge", + style: { + "line-color": "#AAAAAA", + "target-arrow-color": "#AAAAAA", + "target-arrow-shape": "triangle", + "curve-style": "bezier", + }, + }, + ]; + + return ( +
+

Graph Visualization

+ +
+ ); +}; + +export default GraphVisualization; diff --git a/examples/bookmind_app/src/pages/searchTestPage/InitializeMemory.jsx b/examples/bookmind_app/src/pages/searchTestPage/InitializeMemory.jsx new file mode 100644 index 000000000..751e71b63 --- /dev/null +++ b/examples/bookmind_app/src/pages/searchTestPage/InitializeMemory.jsx @@ -0,0 +1,40 @@ +import React, { useState } from "react"; +import axios from "axios"; + +const InitializeMemory = ({ setGraphData }) => { + const [bookTitle, setBookTitle] = useState(""); + const [message, setMessage] = useState(""); + + const handleInitialize = async () => { + if (!bookTitle) { + setMessage("Please enter a book title."); + return; + } + try { + const response = await axios.post("http://localhost:5001/initialize", { + title: bookTitle, + }); + setGraphData(response.data); + setMessage("Memory initialized successfully!"); + } catch (error) { + console.error(error); + setMessage("Error initializing memory."); + } + }; + + return ( +
+

Initialize Memory

+ setBookTitle(e.target.value)} + placeholder="Enter book title" + /> + + {message &&

{message}

} +
+ ); +}; + +export default InitializeMemory; diff --git a/examples/bookmind_app/src/pages/searchTestPage/QueryMemory.jsx b/examples/bookmind_app/src/pages/searchTestPage/QueryMemory.jsx new file mode 100644 index 000000000..3ce148501 --- /dev/null +++ b/examples/bookmind_app/src/pages/searchTestPage/QueryMemory.jsx @@ -0,0 +1,41 @@ +import React, { useState } from "react"; +import axios from "axios"; + +const QueryMemory = () => { + const [query, setQuery] = useState(""); + const [response, setResponse] = useState(""); + + const handleQuery = async () => { + if (!query) { + setResponse("Please enter a query."); + return; + } + try { + const result = await axios.post("http://localhost:5001/query", { query }); + setResponse(result.data.response); + } catch (error) { + console.error(error); + setResponse("Error querying memory."); + } + }; + + return ( +
+

Ask a Question

+ setQuery(e.target.value)} + placeholder="Enter your question" + /> + + {response && ( +

+ Response: {response} +

+ )} +
+ ); +}; + +export default QueryMemory; diff --git a/examples/bookmind_app/src/pages/searchTestPage/index.jsx b/examples/bookmind_app/src/pages/searchTestPage/index.jsx new file mode 100644 index 000000000..42664876b --- /dev/null +++ b/examples/bookmind_app/src/pages/searchTestPage/index.jsx @@ -0,0 +1,21 @@ +import React, { useState } from "react"; +import InitializeMemory from "./InitializeMemory"; +import QueryMemory from "./QueryMemory"; +import GraphVisualization from "./GraphVisualization"; + +const BookSearch = () => { + const [graphData, setGraphData] = useState(null); + + return ( +
+

Book Memory Agent

+ +
+ {graphData && } +
+ +
+ ); +}; + +export default BookSearch; diff --git a/examples/bookmind_app/src/reportWebVitals.js b/examples/bookmind_app/src/reportWebVitals.js new file mode 100644 index 000000000..5253d3ad9 --- /dev/null +++ b/examples/bookmind_app/src/reportWebVitals.js @@ -0,0 +1,13 @@ +const reportWebVitals = onPerfEntry => { + if (onPerfEntry && onPerfEntry instanceof Function) { + import('web-vitals').then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => { + getCLS(onPerfEntry); + getFID(onPerfEntry); + getFCP(onPerfEntry); + getLCP(onPerfEntry); + getTTFB(onPerfEntry); + }); + } +}; + +export default reportWebVitals; diff --git a/examples/bookmind_app/src/setupTests.js b/examples/bookmind_app/src/setupTests.js new file mode 100644 index 000000000..8f2609b7b --- /dev/null +++ b/examples/bookmind_app/src/setupTests.js @@ -0,0 +1,5 @@ +// jest-dom adds custom jest matchers for asserting on DOM nodes. +// allows you to do things like: +// expect(element).toHaveTextContent(/react/i) +// learn more: https://github.com/testing-library/jest-dom +import '@testing-library/jest-dom'; diff --git a/examples/bookmind_app/tailwind.config.js b/examples/bookmind_app/tailwind.config.js new file mode 100644 index 000000000..8aec68540 --- /dev/null +++ b/examples/bookmind_app/tailwind.config.js @@ -0,0 +1,23 @@ +/** @type {import('tailwindcss').Config} */ +module.exports = { + content: ["./src/**/*.{js,jsx,ts,tsx}"], + theme: { + extend: { + keyframes: { + fadeInUp: { + "0%": { opacity: 0, transform: "translateY(20px)" }, + "100%": { opacity: 1, transform: "translateY(0)" }, + }, + fadeOutDown: { + "0%": { opacity: 1, transform: "translateY(0)" }, + "100%": { opacity: 0, transform: "translateY(-20px)" }, + }, + }, + animation: { + fadeInUp: "fadeInUp 0.3s ease-out", + fadeOutDown: "fadeOutDown 0.3s ease-in", + }, + }, + }, + plugins: [], +}; From b4b72187d40c6adaaa935357ea8d403f594645e0 Mon Sep 17 00:00:00 2001 From: seyeong-han Date: Sat, 30 Nov 2024 14:39:37 -0600 Subject: [PATCH 2/3] fix: get and set env variables --- examples/bookmind_app/server/server.py | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/examples/bookmind_app/server/server.py b/examples/bookmind_app/server/server.py index 830a2b691..d474a0011 100644 --- a/examples/bookmind_app/server/server.py +++ b/examples/bookmind_app/server/server.py @@ -9,6 +9,11 @@ from llama_stack_client.lib.agents.event_logger import EventLogger from llama_stack_client.types.agent_create_params import AgentConfig +# Get env variables +INFERENCE_MODEL = os.environ["INFERENCE_MODEL"] +LLAMA_STACK_PORT = os.environ["LLAMA_STACK_PORT"] +SERVER_PORT = os.environ["SERVER_PORT"] + # Flask setup app = Flask(__name__) CORS(app) @@ -67,7 +72,7 @@ async def get_graph_response(text_response, client): # Get graph structure from LlamaStack graph_response = client.inference.chat_completion( - model_id=os.environ["INFERENCE_MODEL"], + model_id=INFERENCE_MODEL, messages=[ {"role": "system", "content": "You are a data structure expert. Convert text descriptions into graph JSON format."}, {"role": "user", "content": graph_prompt} @@ -104,9 +109,9 @@ async def process_book(book_title): Process the book title, query LlamaStack for characters and relationships, and initialize memory. """ - client = LlamaStackClient(base_url=f"http://localhost:{os.environ['LLAMA_STACK_PORT']}") + client = LlamaStackClient(base_url=f"http://localhost:{LLAMA_STACK_PORT}") agent_config = AgentConfig( - model=os.environ["INFERENCE_MODEL"], + model=INFERENCE_MODEL, instructions="You are a helpful assistant", tools=[{"type": "memory"}], # Enable memory enable_session_persistence=True, @@ -273,4 +278,4 @@ async def query_llama_stack(prompt): if __name__ == "__main__": - app.run(debug=True, port=5001) + app.run(debug=True, port=SERVER_PORT) From ba118e89c2ca214b18718ea3c79a89b10e654502 Mon Sep 17 00:00:00 2001 From: seyeong-han Date: Sat, 30 Nov 2024 14:39:56 -0600 Subject: [PATCH 3/3] docs: first README for BookMind --- examples/bookmind_app/README.md | 112 ++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 examples/bookmind_app/README.md diff --git a/examples/bookmind_app/README.md b/examples/bookmind_app/README.md new file mode 100644 index 000000000..6d4404e47 --- /dev/null +++ b/examples/bookmind_app/README.md @@ -0,0 +1,112 @@ +# BookMind + +[![thumbnail](https://github.com/user-attachments/assets/11c6f1f3-59db-4638-9b1a-68f1d25efec4)](https://youtu.be/DL4-DswxfEM) + +BookMind is a web application that allows users to explore character relationships and storylines in books using AI-powered visualizations. The application provides interactive mind maps, AI chatbots for deep questions, book summaries, and community contributions. + +## Features + +- Interactive Mind Maps: Visualize relationships between characters and plot elements. +- AI Chatbot: Ask deep questions about the book and get insightful answers. +- Book Summaries: Get concise overviews of plots and themes. +- Community Contributions: Add and refine maps with fellow book lovers. + +## Prerequisites + +- Node.js +- Python >= 3.10 +- LlamaStack server running locally +- Environment variables: + - LLAMA_STACK_PORT + - INFERENCE_MODEL + - REACT_APP_GOOGLE_BOOKS_API_KEY + +## Getting Started + +### Run llama-stack + +1. Setting up Ollama server + Please check the [Ollama Documentation](https://github.com/ollama/ollama) on how to install and run Ollama. After installing Ollama, you need to run `ollama serve` to start the server. + +``` +export INFERENCE_MODEL="meta-llama/Llama-3.2-3B-Instruct" + +# ollama names this model differently, and we must use the ollama name when loading the model +export OLLAMA_INFERENCE_MODEL="llama3.2:3b-instruct-fp16" +ollama run $OLLAMA_INFERENCE_MODEL --keepalive 60m +``` + +2. Running `llama-stack` server + +``` +pip install llama-stack + +export LLAMA_STACK_PORT=5000 + +# This builds llamastack-ollama conda environment +llama stack build --template ollama --image-type conda + +conda activate llamastack-ollama + +llama stack run \ + --port $LLAMA_STACK_PORT \ + --env INFERENCE_MODEL=$INFERENCE_MODEL \ + --env OLLAMA_URL=http://localhost:11434 \ + ollama +``` + +### Backend Setup + +1. Install dependencies: + +``` +cd server +pip install -r requirements.txt +``` + +2. Set `.env` in the `server` directory + +You should modify the name of `example.env` to `.env` in the `server` directory. +**Modify INFERENCE_MODEL in example.env with yours.** + +3. Run the server: + +``` +python server.py +``` + +### Frontend Setup + +1. Set up GOOGLE_BOOKS_API_KEY: + +You should rename `example.env` with `.env` and replace `{YOUR_API_KEY}` with your [google_books_api_key](https://developers.google.com/books/docs/v1/using) after getting your api key. + +``` +REACT_APP_GOOGLE_BOOKS_API_KEY={YOUR_API_KEY} +``` + +2. Install dependencies and run the application: + +``` +npm install +npm start +``` + +## Usage + +1. Initialize Memory: Upload your book or choose from the library to initialize memory. +2. AI Analysis: The AI analyzes the book and generates a mind map. +3. Explore Insights: Explore relationships, themes, and Q&A insights. + +## What did we use Llama-stack in BookMind? + +1️⃣ Llama Inference models: You can start a LLM application using various LLM services easily. +2️⃣ RAG with FAISS: We leveraged FAISS in Llama-stack for Retrieval-Augmented Generation, enabling real-time responses to character relationship questions. +3️⃣ Multi-Hop Reasoning: Our system performs sequential inference—first extracting characters and relationships, then generating graphized mind map data in JSON for visual storytelling. + +## Contributors + +[Original Repo](https://github.com/seyeong-han/BookMind) +[seyeong-han](https://github.com/seyeong-han) +[sunjinj](https://github.com/SunjinJ) +[WonHaLee](https://github.com/WonHaLee)