modular struct and files

.gitignore

@@ -0,0 +1 @@
+venv/

README.md

@@ -0,0 +1,109 @@
+# Project Setup Steps
+
+## Steps
+
+### 1. Open a New Folder
+
+### 2. Create a New Virtual Environment
+
+### 3. Install Requirements
+```sh
+pip install -r requirements.txt
+```
+
+### 4. Define Folder Structure & Commit Code to GitHub
+#### a. Create a New Repository
+```sh
+git init
+```
+#### b. Add `.gitignore` and Include `venv/`
+#### c. Commit One File to Establish Connection with GitHub
+#### d. Verify Initial Commit in GitHub
+
+### 5. Create `src` Folder and Make it a Package
+```sh
+mkdir src
+```
+Add `__init__.py` to make it a package.
+
+### 6. Define Project Structure
+Inside `src/`, create a folder `langgraphagenticai/` and add `__init__.py`. Inside it, create:
+- `LLMs/` - `__init__.py`
+- `Nodes/` - `__init__.py`
+- `Graph/` - `__init__.py`
+- `State/` - `__init__.py`
+- `Tools/` - `__init__.py`
+- `Vectorstore/` - `__init__.py`
+- `ui/` - `__init__.py`
+- Lastly, add `main.py`
+
+### 7. Create `app.py` Outside `src/`
+This is the main execution entry point.
+
+## Start Writing Code
+
+### 8. LLM Setup
+#### a. Inside `LLMs/`, create `qroqllm.py` to load LLM via Streamlit UI.
+
+### 9. UI Setup
+#### a. Inside `ui/`, create:
+- `loadui.py`
+- `display_result.py`
+
+#### b. Create a Config File
+Inside `ui/`, create `uiconfigfile.ini` (plain text key-value pairs).
+
+#### c. Create a Config Parser
+Inside `ui/streamlit_ui/`, create `uiconfigfile.py` to read from `uiconfigfile.ini`.
+
+#### d. Implement `loadui.py`
+```python
+from src.langgraphagenticai.ui.uiconfigfile import Config
+```
+- Load sidebar options from the config file
+- Store session state
+- Load UI components (left & right sections)
+
+### 10. Running the UI
+Run the UI to check if it loads correctly:
+```sh
+streamlit run app.py
+```
+
+### 11. Implement `main.py`
+#### a. Execution starts here based on user choices.
+#### b. Load the LLM in `qroqllm.py`.
+#### c. Implement `graph_builder.py` inside `Graph/`.
+- Import `State` inside `graph_builder.py`
+
+#### d. Implement `Nodes`
+- Start with `BasicChatbotNode`.
+```python
+from src.langgraphagenticai.nodes.basic_chatbot_node import BasicChatbotNode
+```
+- Define edges, start, and end functions.
+
+#### e. Connect Graph in `main.py`
+```python
+from src.langgraphagenticai.graph.graph_builder import GraphBuilder
+```
+- Invoke the graph based on use case.
+- Compile and stream results.
+
+#### f. Update Display Results
+Modify `display_result.py` to update UI results and call it in `main.py`.
+```python
+from src.langgraphagenticai.ui.streamlitui.display_result import DisplayResultStreamlit
+```
+
+### 12. Run the Application
+```sh
+streamlit run app.py
+```
+
+
+
+
+
+
+

app.py

@@ -0,0 +1,5 @@
+from src.langgraphagenticai.main import load_langgraph_agenticai_app
+
+
+if __name__=="__main__":
+    load_langgraph_agenticai_app()

requirements.txt

@@ -0,0 +1,8 @@
+langchain
+langgraph
+langchain_community
+langchain_core
+langchain_groq
+langchain_openai
+faiss-cpu
+streamlit

src/langgraphagenticai/LLMS/groqllm.py

@@ -0,0 +1,20 @@
+import os
+import streamlit as st
+from langchain_groq import ChatGroq
+
+class GroqLLM:
+    def __init__(self,user_controls_input):
+        self.user_controls_input=user_controls_input
+
+    def get_llm_model(self):
+        try:
+            groq_api_key=self.user_controls_input['GROQ_API_KEY']
+            selected_groq_model=self.user_controls_input['selected_groq_model']
+            if groq_api_key=='' and os.environ["GROQ_API_KEY"] =='':
+                st.error("Please Enter the Groq API KEY")
+
+            llm = ChatGroq(api_key =groq_api_key, model=selected_groq_model)
+
+        except Exception as e:
+            raise ValueError(f"Error Occurred with Exception : {e}")
+        return llm

src/langgraphagenticai/graph/graph_builder.py

@@ -0,0 +1,39 @@
+from langgraph.graph import StateGraph, START,END, MessagesState
+from langgraph.prebuilt import tools_condition,ToolNode
+from langchain_core.prompts import ChatPromptTemplate
+from src.langgraphagenticai.state.state import State
+from src.langgraphagenticai.nodes.basic_chatbot_node import BasicChatbotNode
+
+
+
+
+class GraphBuilder:
+
+    def __init__(self,model):
+        self.llm=model
+        self.graph_builder=StateGraph(State)
+
+    def basic_chatbot_build_graph(self):
+        """
+        Builds a basic chatbot graph using LangGraph.
+        This method initializes a chatbot node using the `BasicChatbotNode` class 
+        and integrates it into the graph. The chatbot node is set as both the 
+        entry and exit point of the graph.
+        """
+        self.basic_chatbot_node=BasicChatbotNode(self.llm)
+        self.graph_builder.add_node("chatbot",self.basic_chatbot_node.process)
+        self.graph_builder.add_edge(START,"chatbot")
+        self.graph_builder.add_edge("chatbot",END)
+
+    def setup_graph(self, usecase: str):
+        """
+        Sets up the graph for the selected use case.
+        """
+        if usecase == "Basic Chatbot":
+            self.basic_chatbot_build_graph()
+        return self.graph_builder.compile()
+
+
+
+    
+

src/langgraphagenticai/main.py

@@ -0,0 +1,66 @@
+import streamlit as st
+import json
+from src.langgraphagenticai.ui.streamlitui.loadui import LoadStreamlitUI
+from src.langgraphagenticai.LLMS.groqllm import GroqLLM
+from src.langgraphagenticai.graph.graph_builder import GraphBuilder
+from src.langgraphagenticai.ui.streamlitui.display_result import DisplayResultStreamlit
+
+# MAIN Function START
+def load_langgraph_agenticai_app():
+    """
+    Loads and runs the LangGraph AgenticAI application with Streamlit UI.
+    This function initializes the UI, handles user input, configures the LLM model,
+    sets up the graph based on the selected use case, and displays the output while 
+    implementing exception handling for robustness.
+    """
+   
+    # Load UI
+    ui = LoadStreamlitUI()
+    user_input = ui.load_streamlit_ui()
+
+    if not user_input:
+        st.error("Error: Failed to load user input from the UI.")
+        return
+
+    # Text input for user message
+    if st.session_state.IsFetchButtonClicked:
+        user_message = st.session_state.timeframe 
+    else :
+        user_message = st.chat_input("Enter your message:")
+
+    if user_message:
+            try:
+                # Configure LLM
+                obj_llm_config = GroqLLM(user_controls_input=user_input)
+                model = obj_llm_config.get_llm_model()
+                
+                if not model:
+                    st.error("Error: LLM model could not be initialized.")
+                    return
+
+                # Initialize and set up the graph based on use case
+                usecase = user_input.get('selected_usecase')
+                if not usecase:
+                    st.error("Error: No use case selected.")
+                    return
+                
+
+                ### Graph Builder
+                graph_builder=GraphBuilder(model)
+                try:
+                    graph = graph_builder.setup_graph(usecase)
+                    DisplayResultStreamlit(usecase,graph,user_message).display_result_on_ui()
+                except Exception as e:
+                    st.error(f"Error: Graph setup failed - {e}")
+                    return
+                
+
+            except Exception as e:
+                 raise ValueError(f"Error Occurred with Exception : {e}")
+            
+
+        
+
+   
+
+    

src/langgraphagenticai/nodes/basic_chatbot_node.py

@@ -0,0 +1,14 @@
+from src.langgraphagenticai.state.state import State
+
+class BasicChatbotNode:
+    """
+    Basic chatbot logic implementation.
+    """
+    def __init__(self,model):
+        self.llm = model
+
+    def process(self, state: State) -> dict:
+        """
+        Processes the input state and generates a chatbot response.
+        """
+        return {"messages":self.llm.invoke(state['messages'])}

src/langgraphagenticai/state/state.py

@@ -0,0 +1,11 @@
+from typing import Annotated, Literal, Optional
+from typing_extensions import TypedDict
+from langgraph.graph.message import add_messages
+from typing import TypedDict, Annotated, List
+from langchain_core.messages import HumanMessage, AIMessage
+
+class State(TypedDict):
+    """
+    Represents the structure of the state used in the graph.
+    """
+    messages: Annotated[list, add_messages]

src/langgraphagenticai/ui/streamlitui/display_result.py

@@ -0,0 +1,24 @@
+import streamlit as st
+from langchain_core.messages import HumanMessage,AIMessage
+import json
+
+
+class DisplayResultStreamlit:
+    def __init__(self,usecase,graph,user_message):
+        self.usecase= usecase
+        self.graph = graph
+        self.user_message = user_message
+
+    def display_result_on_ui(self):
+        usecase= self.usecase
+        graph = self.graph
+        user_message = self.user_message
+        if usecase =="Basic Chatbot":
+                for event in graph.stream({'messages':("user",user_message)}):
+                    print(event.values())
+                    for value in event.values():
+                        print(value['messages'])
+                        with st.chat_message("user"):
+                            st.write(user_message)
+                        with st.chat_message("assistant"):
+                            st.write(value["messages"].content)

src/langgraphagenticai/ui/streamlitui/loadui.py

@@ -0,0 +1,64 @@
+import streamlit as st
+import os
+from datetime import date
+
+from langchain_core.messages import AIMessage,HumanMessage
+from src.langgraphagenticai.ui.uiconfigfile import Config
+
+
+class LoadStreamlitUI:
+    def __init__(self):
+        self.config =  Config() # config
+        self.user_controls = {}
+
+    def initialize_session(self):
+        return {
+        "current_step": "requirements",
+        "requirements": "",
+        "user_stories": "",
+        "po_feedback": "",
+        "generated_code": "",
+        "review_feedback": "",
+        "decision": None
+    }
+  
+
+
+    def load_streamlit_ui(self):
+        st.set_page_config(page_title= "🤖 " + self.config.get_page_title(), layout="wide")
+        st.header("🤖 " + self.config.get_page_title())
+        st.session_state.timeframe = ''
+        st.session_state.IsFetchButtonClicked = False
+        st.session_state.IsSDLC = False
+        
+        
+
+        with st.sidebar:
+            # Get options from config
+            llm_options = self.config.get_llm_options()
+            usecase_options = self.config.get_usecase_options()
+
+            # LLM selection
+            self.user_controls["selected_llm"] = st.selectbox("Select LLM", llm_options)
+
+            if self.user_controls["selected_llm"] == 'Groq':
+                # Model selection
+                model_options = self.config.get_groq_model_options()
+                self.user_controls["selected_groq_model"] = st.selectbox("Select Model", model_options)
+                # API key input
+                self.user_controls["GROQ_API_KEY"] = st.session_state["GROQ_API_KEY"] = st.text_input("API Key",
+                                                                                                      type="password")
+                # Validate API key
+                if not self.user_controls["GROQ_API_KEY"]:
+                    st.warning("⚠️ Please enter your GROQ API key to proceed. Don't have? refer : https://console.groq.com/keys ")
+                   
+            
+            # Use case selection
+            self.user_controls["selected_usecase"] = st.selectbox("Select Usecases", usecase_options)
+            
+            if "state" not in st.session_state:
+                st.session_state.state = self.initialize_session()
+            
+            
+        
+        return self.user_controls

src/langgraphagenticai/ui/uiconfigfile.ini

@@ -0,0 +1,6 @@
+[DEFAULT]
+PAGE_TITLE = LangGraph: Build Stateful Agentic AI graph
+LLM_OPTIONS = Groq
+USECASE_OPTIONS = Basic Chatbot
+GROQ_MODEL_OPTIONS = mixtral-8x7b-32768, llama3-8b-8192, llama3-70b-8192, gemma-7b-i
+

src/langgraphagenticai/ui/uiconfigfile.py

@@ -0,0 +1,19 @@
+from configparser import ConfigParser
+
+class Config:
+    def __init__(self,config_file="./src/langgraphagenticai/ui/uiconfigfile.ini"):
+        self.config=ConfigParser()
+        self.config.read(config_file)
+
+    def get_llm_options(self):
+        return self.config["DEFAULT"].get("LLM_OPTIONS").split(", ")
+    
+    def get_usecase_options(self):
+        return self.config["DEFAULT"].get("USECASE_OPTIONS").split(", ")
+
+    def get_groq_model_options(self):
+        return self.config["DEFAULT"].get("GROQ_MODEL_OPTIONS").split(", ")
+
+    def get_page_title(self):
+        return self.config["DEFAULT"].get("PAGE_TITLE")
+