Add Kaggle Challenge Solver AI Agent

README.md

@@ -96,7 +96,7 @@ If you're a company in the AI agent ecosystem or would like to judge the hackath
 - [🎮 AI 3D PyGame Visualizer with DeepSeek R1](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/ai_agent_tutorials/ai_3dpygame_r1)
 - [🧠 AI Reasoning Agent](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/ai_agent_tutorials/ai_reasoning_agent)
 - [🧬 Multimodal AI Agent](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/ai_agent_tutorials/multimodal_ai_agent)
-
+- [🌟 Kaggle Challenge Solver AI Agent](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/ai_agent_tutorials/kaggle_agent)
 ### RAG (Retrieval Augmented Generation)
 - [🔍 Autonomous RAG](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/rag_tutorials/autonomous_rag)
 - [🔗 Agentic RAG](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/rag_tutorials/agentic_rag)

ai_agent_tutorials/kaggle_agent/README.md

@@ -0,0 +1,111 @@
+## 🌟 Kaggle Challenge Solver
+
+This isn't just any old problem solver – it's your AI-powered companion in the wild world of Kaggle competitions. Using a "plan and execute" strategy that would make any project manager jealous, our system tackles ML problems with the finesse of a seasoned data scientist and the tireless energy of a thousand interns. **code generation agent is inspired from langgraph agent [<u>link</u>](https://blog.langchain.dev/code-execution-with-langgraph/)**
+
+## 🧠 Key Components
+
+1. **The Mastermind (KaggleProblemPlanner)**: Plans your path to Kaggle glory!
+2. **The Perfectionist (KaggleTaskEnhancer)**: Turns good tasks into great ones!
+3. **The Code Wizard (CodeGenerationAgent)**: Conjures code like magic! ✨
+4. **The Strategist (KaggleProblemRePlanner)**: Adapts faster than a chameleon in a rainbow!
+5. **The Executor (KaggleCodeExecutor)**: Runs code faster than you can say "machine learning"!
+
+## 🔄 Workflow: The Circle of AI Life
+
+1. Scrape → 2. Data analyze → 3. Plan →( 4. Enhance → 5. Code → 6. Execute )→ Repeat!
+
+It's like a never-ending dance party, but with more algorithms and less awkward small talk.
+
+## 🎭 The Agent Graph: A Visual Spectacle
+
+Behold, the pièce de résistance of our project – the Agent Graph! 📊
+
+```mermaid
+graph TB
+    %% Define styles
+    style A fill:#f9f,stroke:#333,stroke-width:2px
+    style H fill:#f9f,stroke:#333,stroke-width:2px
+    style B fill:#bbf,stroke:#333,stroke-width:1px
+    style D fill:#fcc,stroke:#333,stroke-width:1px
+    style E fill:#ffc,stroke:#333,stroke-width:1px
+    style F fill:#ccf,stroke:#333,stroke-width:1px
+    style G fill:#fcf,stroke:#333,stroke-width:1px
+
+    A((Start)) --> B[Scraper]
+    B --> G[Data Utils]
+    G --> D[Planner]
+    D --> F[Enhancer]
+    F --> I
+    H((Finish))
+
+    subgraph Code_Agent_Process [Code Agent Process]
+        style Code_Agent_Process fill:#cfc,stroke:#333,stroke-width:1px
+        I((Start))
+        J[Generate Code]
+        K{Ran Error Free?}
+        L((Finish))
+        M[Reflect On Error]
+
+        I --> J
+        J --> K
+        K -- Yes --> L
+        K -- No --> M
+        M --> J
+    end
+
+    %% Link the main process to subgraph
+
+    L -->|Returns| E[Executor]
+
+    %% Annotations
+    classDef annotation fill:#fff,stroke:none,color:#333,font-size:12px;
+    class B,G,D,F,E annotation;
+
+    %% Annotating Feedback Loops
+    E -. Feedback Loop .-> F
+    E -. Completion .-> H
+
+```
+
+### How to get Started?
+
+1. Clone this repo faster than you can say "git":
+
+   ```bash
+   git clone https://github.com/msnp1381/kaggle-agent.git
+   ```
+
+2. Install Poetry if you haven't already:
+
+   ```bash
+   curl -sSL https://install.python-poetry.org | python3 -
+   ```
+
+3. Set up the Python environment:
+
+   ```bash
+   poetry install
+   ```
+
+4. Run pip install for notebook requirements:
+
+    ```bash
+    pip install -r notebook_requirements.txt 
+    ```
+
+5. Configure the project:
+
+   - Copy the `.env.template` file to `.env`:
+
+     ```bash
+     cp .env.template .env
+     ```
+
+   - Open the `.env` file and fill in the required environment variables.
+   - **Review** and update the `config.ini` file if necessary.
+
+5. Run the main script:
+
+   ```bash
+   poetry run python main.py
+   ```