https://github.com/kwame-mintah/python-hugging-face-smolagents-playground
🛝 \ ˈplā-ˌgrau̇nd \ an area known or suited for activity of a specified sort.
https://github.com/kwame-mintah/python-hugging-face-smolagents-playground
agents huggingface langchain python311 sentence-transformers smolagents
Last synced: about 1 month ago
JSON representation
🛝 \ ˈplā-ˌgrau̇nd \ an area known or suited for activity of a specified sort.
- Host: GitHub
- URL: https://github.com/kwame-mintah/python-hugging-face-smolagents-playground
- Owner: kwame-mintah
- Created: 2025-07-01T16:54:14.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-10-15T12:03:11.000Z (8 months ago)
- Last Synced: 2025-10-16T05:43:22.033Z (8 months ago)
- Topics: agents, huggingface, langchain, python311, sentence-transformers, smolagents
- Language: Python
- Homepage:
- Size: 520 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛝 Hugging face smolagents playground
As the name of the repository suggests, it's just a [
_playground_](https://dictionary.cambridge.org/dictionary/english/playground). A place to better understand Hugging
Face [smolagents](https://huggingface.co/docs/smolagents/index)
and how it can be utilised for various tasks and create a multi-agent workflow.
## Prerequisites
1. [Docker for desktop](https://docs.docker.com/desktop/)
2. [Ollama](https://ollama.com/download)
3. [uv](https://docs.astral.sh/uv/#installation)
### Usage via `pip`
1. Install python packages used for the project
```pycon
pip install -r requirements.txt
```
2. Run the application
```pycon
python main.py
```
### Usage via `uv`
1. Install python packages used for the project
```pycon
uv sync
```
2. Run the application
```pycon
uv run main.py
```
## Environment variables
The following environment variables are used by this project.
| Environment Variable | Description | Default Value |
| ---------------------------------- | -------------------------------------------------------------- | ---------------------------------------- |
| AGENT_TASK | The task the agent needs to complete | Create a hello world app, using FastAPI. |
| LLM_PROVIDER | The inference model provider to use | ollama |
| OLLAMA_BASE_API_URL | The ollama server URL | http://localhost:11434 |
| OLLAMA_MODEL_NAME | The Ollama model to be used for inference | ollama/mistral:7b |
| GOOGLE_API_KEY | Your Google Gemini API key | |
| GOOGLE_GEMINI_LLM_MODEL | The Gemini model to use | gemini-2.5-flash |
| HUGGING_FACE_IMAGE_GENERATION_TOOL | The name of the hugging face repository tool for text to image | m-ric/text-to-image |
| HUGGING_FACE_INFERENCE_MODEL | The name of the hugging face repository for model inference | Qwen/Qwen2.5-72B-Instruct |