Voyage AI Python SDK 0.6.0: tokenizers now load from the MongoDB Hugging Face org (November 10, 2026)
voyageai 0.6.0 fetches tokenizers and voyage-4-nano from MongoDB on Hugging Face. Online is fine; offline caches need a refresh.
Your keys
0 of 1 ready
Create each key on its own page, paste it below, then copy the finished lines into your project's .env file. What you paste stays in this tab. It is never sent to Wirestack or saved.
- Voyage API keyVOYAGE_API_KEYGet key
Sign in, open API keys, click Create new secret key, then copy and store it safely.
What changed
The voyageai Python SDK 0.6.0 (November 10, 2026) now downloads its Hugging Face files from the MongoDB org instead of voyageai. That covers the tokenizers used by count_tokens() and tokenize(), the multimodal client_config.json, and the voyage-4-nano local model. The release also adds X-VoyageAI-* request headers.
Online setups keep working: the pull request says old voyageai/<model> addresses on Hugging Face redirect to MongoDB/<model>, and that tokenizer output and voyage-4-nano embeddings are identical under the new name.
Offline setups are the risk. The SDK now asks for MongoDB/<model> with no fallback to the old name, and if loading fails it warns and raises the error. The Hugging Face cache stores each repo in a folder named after its org (for example models--voyageai--voyage-3 versus models--MongoDB--voyage-3), so a cache filled by an older SDK version is under the old name.
Prerequisites
- A Voyage AI API key in
VOYAGE_API_KEY - Python with
voyageaiandtokenizersinstalled - For offline machines: one run with internet access to fill the cache under the new name
Steps
- Upgrade:
pip install -U voyageai==0.6.0. - If you only call the API online, nothing else is needed.
- If your servers run with
HF_HUB_OFFLINE=1or have no internet, fill the cache again on a connected machine with 0.6.0 by callingvo.count_tokens(["hello"], model="voyage-3.5")for each model you tokenize, and loadvoyage-4-nanoonce if you run it locally. - Copy the new
models--MongoDB--...folders into the cache your offline servers use (HF_HOMEor ).