TinyCodeAgent

TinyCodeAgent

An agent that solves tasks by writing Python, running it and fixing its own errors, built on TinyAgent with a Qwen model. Also works as an MCP server. For agent builders and developers.

Made by Agents-MCP-Hackathon on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: TinyCodeAgent is an AI agent that solves a task by writing Python, running it and fixing its own errors. It can build helper functions as it goes. It is made on the TinyAgent framework, uses Qwen/Qwen3-235B-A22B, and can serve as an MCP server or as a tool for another agent.

Who it suits: Developers who want to see a code-writing agent that tests and repairs its own snippets, and people who want to extend an agent with hooks.

Industry | Who uses it | How they use it | Example
AI development | Agent builders | Study an agent that writes and debugs code | Watching it retry after a traceback
Data work | Analysts | Ask for quick calculations | Asking for the root mean square error of two lists
Operations | Developers | Use the agent as a tool for another agent | Connecting it through MCP

You can skip it if you want a fixed workflow, since the agent decides its own code and tools.

Where to use it:

• A web browser, on the Space's own page at Hugging Face
• An MCP client, since the Space carries an MCP tag
• A copy on your own computer, using Python on Windows, macOS or Linux

Use case | Who | What they get back
Solve a task with code | Anyone | An answer found by running Python the agent wrote
Find popular Spaces | Hobbyists | A list built from Hugging Face's Spaces
Extend an agent | Developers | A base to add hooks, storage and extra MCP connections

How to set it up:

• A browser, if you only use the Space online
• Python and pip, if you run a copy yourself
• The source credits Modal Functions for running the Python code and Nebius for the Qwen model

1. Open the Space's page on Hugging Face to use it online. Nothing needs installing.
2. For a local copy, install the huggingface_hub package and download the Space's files.
3. Move into the new folder, then install Gradio and the packages in requirements.txt.
4. Start the app with python.

pip install -U huggingface_hub
hf download Agents-MCP-Hackathon/TinyCodeAgent --repo-type space --local-dir TinyCodeAgent
cd TinyCodeAgent
pip install gradio==5.33.1
pip install -r requirements.txt

How to use it: Type a task into the chat and let the agent work. It writes code, runs it, reads any error and tries again until the task is solved. On your own computer, start the app first and open the page it serves.

python app.py

Tool | What it does
python app.py | Starts the agent's web page on your own computer
TinyAgent hooks | Let you extend the agent's behavior
Gradio integration | Lets another agent use this one as a tool

Example: You ask, "Which Spaces are trending on Hugging Face right now?" The agent writes Python to fetch and list them, and you see the answer it produces.

For newcomers and experts: If you are new to this, try one of the sample questions, such as the root mean square error of two lists. Watch how the agent writes code to answer it.

For experts, the agent keeps state across code runs through Modal Functions rather than a sandbox, which the source says is faster and cheaper. It logs, stores data, supports several MCP connections and reaches other models through LiteLLM. Its system prompt builds on the SmolAgents coding prompt.

You describe a task
The agent writes Python
The code runs and is tested
Errors are read and fixed
The solved result comes back

Good to know:

• Built with Gradio 5.33.1, and the main file is app.py
• License: apache-2
• Cost to run: none named, though it relies on Modal Functions and a Qwen model hosted by Nebius
• Data it reaches: the code it writes and the services it calls, such as Hugging Face's Spaces list
• Some examples use dummy functions for demonstration, such as the weather and traffic ones

On Hugging Face, 13 November 2026

• Likes: 29
• Built with: gradio
• License: apache-2.0

Links

• Space: https://huggingface.co/spaces/Agents-MCP-Hackathon/TinyCodeAgent
• Files: https://huggingface.co/spaces/Agents-MCP-Hackathon/TinyCodeAgent/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.