files pushed

README.md

@@ -9,4 +9,31 @@ license: mit
 short_description: The JARVIS (Just A Rather Very Intelligent System) project
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Jarvis Gaia Agent
+
+A Python-based AI agent leveraging `langchain`, `duckduckgo-search`, and `pytesseract` to perform web searches, document parsing, and multi-hop query refinement. Deployed as a Hugging Face Space for interactive use.
+
+## Features
+
+- **Web Search**: Performs asynchronous searches using DuckDuckGo.
+- **Multi-Hop Search**: Refines complex queries iteratively with OpenAI's GPT-4o.
+- **Document Parsing**: Extracts text from PDFs and images using `PyPDF2` and `pytesseract`.
+- **Modular Tools**: Includes calculator, file parser, and document retriever.
+- **Observability**: Integrated with Langfuse for monitoring.
+
+## Prerequisites
+
+- Python 3.11
+- Tesseract OCR (`brew install tesseract` on macOS)
+- API keys for:
+  - OpenAI (`OPENAI_API_KEY`)
+  - Hugging Face (`HUGGINGFACEHUB_API_TOKEN`)
+  - Groq (`GROQ_API_KEY`)
+  - Langfuse (`LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`, `LANGFUSE_HOST`)
+
+## Setup
+
+1. **Clone the Repository**:
+   ```bash
+   git clone https://github.com/your-username/jarvis_gaia_agent.git
+   cd jarvis_gaia_agent