Spaces:
Running
Running
| title: First Agent Template | |
| emoji: ⚡ | |
| colorFrom: pink | |
| colorTo: yellow | |
| sdk: gradio | |
| sdk_version: 5.23.1 | |
| app_file: app.py | |
| pinned: false | |
| tags: | |
| - smolagents | |
| - agent | |
| - smolagent | |
| - tool | |
| - agent-course | |
| Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference | |
| # 🤖 First Agent Project with smolagents | |
| An intelligent, code-backed AI agent capable of dynamic tool execution, reasoning, and multi-modal tasks (like text-to-image generation and timezone calculations). Built using the `smolagents` framework, powered by `Qwen2.5-Coder-32B-Instruct`, and deployed seamlessly on Hugging Face Spaces with a user-friendly Gradio interface. | |
| ## 🚀 What This Project Is About | |
| This project demonstrates the implementation of a full **CodeAgent** using the `smolagents` library. Unlike traditional rigid chatbots, this agent operates on a **Thought-Action-Observation** cycle. When given a complex prompt, it writes execution blocks in Python, leverages specialized tools, evaluates the live feedback, and formulates an accurate final response. | |
| ### Core Features | |
| * **Dynamic Code Execution:** Solves problems by interpreting and running Python blocks on the fly. | |
| * **Custom Tool Integration:** Extensible structure to add your own Python functions as agent tools. | |
| * **Text-to-Image Generation:** Connects directly to Hugging Face Hub inference models to visualize user prompts. | |
| * **Gradio Web UI:** A clean, shareable interface for interactive chatting and multi-modal outputs. | |
| ## 🛠️ Tech Stack | |
| * **Framework:** [smolagents](https://github.com/huggingface/smolagents) (Hugging Face) | |
| * **LLM Engine:** `Qwen/Qwen2.5-Coder-32B-Instruct` (via Hugging Face Serverless Inference API) | |
| * **UI Framework:** [Gradio](https://gradio.app/) | |
| * **Language:** Python 3.10+ | |
| * **Libraries:** `pytz`, `pyyaml`, `requests` | |
| ## 📁 Project Structure | |
| ```text | |
| ├── app.py # Main entry point: initializes the model, tools, and Gradio UI | |
| ├── prompts.yaml # System prompts and instruction templates for the agent | |
| ├── requirements.txt # Python dependencies | |
| ├── Gradio_UI.py # Helper script setting up the Gradio layout | |
| └── tools/ | |
| └── final_answer.py # Core tool defining how the agent concludes its reasoning |