Snapshot of huggingface/ml-intern: 10.8k★, Python, Developer Tools. Archived — ML Intern is no longer maintained. Continue with HuggingChat.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
[!IMPORTANT]
ML Intern is no longer maintained. Both the hosted web application and the ml-intern CLI have been retired. Continue with HuggingChat.
This repository is retained for historical reference only. No support, bug fixes, or security updates will be provided.
ML Intern (retired)
Historical documentation (unsupported)
The documentation below is preserved for historical reference. The project is no longer supported or maintained.
ML Intern was an agent that autonomously researched, wrote, and shipped ML-related code using the Hugging Face ecosystem, with deep access to documentation, papers, datasets, and cloud compute.
All API-based model calls go through Hugging Face Inference Providers, so your HF_TOKEN must be allowed to make Inference Provider calls. If no HF_TOKEN is set, the CLI will prompt you to paste one on first launch unless you start on a local model. To get a GITHUB_TOKEN follow the tutorial here. See the local models section below for instructions on using agents that run on your hardware.
Run ml-intern then /model to see the full list of suggested model ids
(Claude, GPT, HF Router models like MiniMax, Kimi, GLM, DeepSeek, and local
model prefixes).
Hosted inference is billed to the active Hugging Face user. See below on how to run ml-intern with local models.
Local models
Local model support uses OpenAI-compatible HTTP endpoints through LiteLLM. The
agent does not load model weights directly from disk; start your inference
server first, then select it with a provider-specific model prefix:
Set LOCAL_LLM_BASE_URL and optional LOCAL_LLM_API_KEY to use one shared
local endpoint, or override a specific provider with its matching *_BASE_URL
/ *_API_KEY variable, such as OLLAMA_BASE_URL or VLLM_API_KEY.
Provider-specific variables take precedence over the shared local variables.
Base URLs may include or omit /v1.
CLI tool runtime:
By default, the CLI runs bash, read, write, and edit on your local
filesystem. To use HF Space sandbox tools instead, including sandbox_create,
opt in with --sandbox-tools:
ml-intern --sandbox-tools "test this training script in a GPU sandbox"
ml-intern --model llamacpp/ggml-org/gemma-3-1b-it-GGUF --sandbox-tools
Sandbox tool runtime requires HF_TOKEN, even when the selected model is local,
because it creates private HF Spaces. You can also make sandbox tools your CLI
default in ~/.config/ml-intern/cli_agent_config.json:
{ "tool_runtime": "sandbox" }
Use the default local runtime when you want tools to inspect or edit files in
your checkout. Use sandbox runtime when you want the agent to create or replace
an HF Space sandbox, test code remotely, or request GPU sandbox hardware before
launching larger HF Jobs.
Sharing Traces
Every session is auto-uploaded to your own private Hugging Face dataset
in Claude Code JSONL format,
which the HF Agent Trace Viewer auto-detects so you can browse turns, tool
calls, and model responses directly on the Hub.
By default the dataset is named {your-hf-username}/ml-intern-sessions and is
created private. You can flip it to public from inside the CLI:
/share-traces # show current visibility + dataset URL
/share-traces public # publish (anyone can view)
/share-traces private # lock it back down
You can also flip visibility from the dataset page on huggingface.co — the
agent honours whatever you set there for subsequent uploads.
To opt out entirely, set in your CLI config (e.g. configs/cli_agent_config.json
or ~/.config/ml-intern/cli_agent_config.json):
The shared smolagents/ml-intern-sessions dataset is unrelated and only
receives anonymized telemetry rows used by the backend KPI scheduler.
Supported Gateways
ML Intern currently supports one-way notification gateways from CLI sessions.
These gateways send out-of-band status updates; they do not accept inbound chat
messages.
Slack
Slack notifications use the Slack Web API to post messages when the agent needs
approval, hits an error, or completes a turn. Create a Slack app with a bot token
that has chat:write, invite the bot to the target channel, then set:
SLACK_BOT_TOKEN=xoxb-...
SLACK_CHANNEL_ID=C...
The CLI automatically creates a slack.default destination when both variables
are present. Optional environment variables for the env-only default:
Note: Environment variables like ${YOUR_TOKEN} are auto-substituted from .env.
Cite ml-intern
If you use ml-intern in your work, please cite it by using the following BibTeX entry or similar.
@Misc{ml-intern,
title = {ml-intern: an agent that autonomously researches, writes, and ships good quality ML related code using the Hugging Face ecosystem},
author = {Aksel Joonas Reedi, Henri Bonamy, Yoan Di Cosmo, Leandro von Werra, Lewis Tunstall},
howpublished = {\url{https://github.com/huggingface/ml-intern}},
year = {2026}
}
How active is development on huggingface/ml-intern?
The most recent commit recorded on huggingface/ml-intern was 2 months ago, based on the GitHub push timestamp. The repository has 1.2k forks — one of the better signals of community interest.
How many stars does huggingface/ml-intern have?
huggingface/ml-intern has 10.8k GitHub stars — refresh the page for the live number, or check github.com/huggingface/ml-intern. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is huggingface/ml-intern open source?
Yes — huggingface/ml-intern ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/huggingface/ml-intern.
What else is in the Developer Tools space?
huggingface/ml-intern is tracked by TopGit under the Developer Tools category. Trending and Topics pages list peer repositories of comparable stars and language.
What is huggingface/ml-intern?
huggingface/ml-intern (huggingface/ml-intern) is a Python project on GitHub. From the project's own README: Archived — ML Intern is no longer maintained. Continue with HuggingChat.
What language is huggingface/ml-intern written in?
huggingface/ml-intern is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
What license does huggingface/ml-intern use?
huggingface/ml-intern is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about huggingface/ml-intern?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/huggingface/ml-intern is the definitive source.
Read full README in the tab above.
Still deciding about ml-intern?
One click hands the question to an AI along with this page — see what it says about ml-intern.