Create README.md

README.md

@@ -0,0 +1,75 @@
+# AutoScholar
+
+AutoScholar is an autonomous multi-step research agent/assistant built with LangGraph. Given any research topic, it plans a search strategy, queries the web, reads and extracts content from sources, and formulates a structured, cited report — without any manual intervention.
+It uses a self-reflection loop to evaluate the quality of its output and automatically re-searches if the report doesn't fully answer the original question.
+
+---
+
+
+## How It Works
+
+When a user submits a research topic, the agent runs through a graph of nodes — each responsible for one stage of the research process:
+  1. Planner — The LLM breaks the topic into 3-4 specific sub-questions worth searching for independently.
+  2. Search — Each sub-question is sent to the Tavily Search API, which returns clean, LLM-ready results including URLs and content snippets.
+  3. Reader — The top URLs are fetched and parsed with BeautifulSoup, extracting the main body text and stripping unwanted data.
+  4. Synthesizer — All gathered content is assembled into a prompt and sent to the LLM, which writes a structured report with an introduction, key findings, and conclusion.
+  5. Reflection — The LLM evaluates whether the report fully answers the original question. If not, the agent loops back to the Search node with refined queries. The loop is capped at 2 iterations to prevent infinite cycles.
+
+---
+
+## Agent Graph
+
+```
+[Planner] → [Search] → [Reader] → [Synthesizer] → [Reflection]
+                ↑                                        ↓
+                └──────────── re-search if needed ───────┘
+                                                         ↓
+                                                        END
+```
+
+---
+
+## Project Structure
+
+```
+
+AutoScholar/
+├── app/
+│   ├── agent/
+│   │   ├── nodes/
+│   │   │   ├── planner.py
+│   │   │   ├── search.py
+│   │   │   ├── reader.py
+│   │   │   ├── synthesizer.py
+│   │   │   └── reflection.py
+│   │   ├── graph.py
+│   │   └── state.py
+│   └── streamlit.py
+└── README.md
+
+```
+  
+---
+
+## Workflow
+
+User Topic  
+     ↓  
+Planner (LLM)  
+     ↓  
+Tavily Web Search × N sub-questions  
+     ↓  
+BeautifulSoup Page Reader  
+     ↓  
+Synthesizer (LLM)  
+     ↓  
+Reflection (LLM)  
+     ↓  
+Structured Report  
+
+---
+
+## AutoScholar UI
+
+<img width="388" height="642" alt="Screenshot 2026-03-12 at 11 15 39 AM" src="https://github.com/user-attachments/assets/8dce02eb-03e2-46f5-9ab6-5310cec131f6" />
+