README.md

metadata

title: Agent with smolagents + DeepSeek
emoji: 🧠
colorFrom: indigo
colorTo: blue
sdk: gradio
app_file: main.py
pinned: false

Hugging Face Agent Project

This project implements a Hugging Face agent using the smolagents framework. The agent is designed to handle various tasks by utilizing custom tools and models.

Project Structure

huggingface-agent-project
├── main.py               # Entry point for the agent
├── agent_config.py       # Configuration and model loading
├── tools                 # Directory for custom tools
│   ├── __init__.py       # Package initializer for tools
│   ├── wiki_tool.py      # Tool for fetching Wikipedia summaries
│   ├── web_search_tool.py # Tool for performing web searches using DuckDuckGo
│   ├── excel_analysis_tool.py # Tool for analyzing Excel files
├── requirements.txt      # Project dependencies
└── README.md             # Project documentation

Setup Instructions

1. Clone the repository:

   git clone <repository-url>
   cd huggingface-agent-project
   

2. Install the required dependencies:

   pip install -r requirements.txt
   

Usage

To run the agent, execute the following command:

python main.py

Agent Capabilities

The agent is capable of performing various tasks by leveraging the following tools:

Tools

• WikiTool: Fetches summaries of topics from Wikipedia, handling disambiguation and page errors gracefully.
• WebSearchTool: Performs web searches using DuckDuckGo and retrieves the first result's snippet.
• ExcelAnalysisTool: Loads an Excel file and sums sales from items labeled as "food", excluding drinks. Returns the total sales in USD with 2 decimal places.

Models

• The agent uses the Hugging Face Inference API via HfApiModel to interact with models such as DeepSeek-R1 or DeepSeek-Coder.

Example Workflow

1. The agent receives a request.
2. Based on the request, it selects the appropriate tool (e.g., WikiTool for Wikipedia lookups).
3. The tool processes the request and returns the result.

Contributing

Contributions are welcome! Please submit a pull request or open an issue for any enhancements or bug fixes.

Future Enhancements

• Deployment to Hugging Face Spaces.
• Adding more tools for advanced functionalities.
• Improving error handling and logging.