v0.1.0 - Initial PyPI Release

🎉 First Official Release

FreeRouter is now available on PyPI!

pip install freerouter

✨ Features

• Multi-Provider Support: OpenRouter, iFlow, ModelScope, Ollama, and any OpenAI-compatible API
• Automatic Model Discovery: Fetch available models from providers automatically
• CLI Tools: Easy-to-use commands for configuration and management
• LiteLLM Integration: Unified API interface for all providers
• Free Model Access: Support for multiple free LLM providers

📦 Supported Providers

Provider	Models	Free Quota	Status
OpenRouter	30+ models	Many free models	✅
iFlow	Multiple	All models free	✅
ModelScope	60+ models	2000 calls/day	✅
Ollama	Local models	Unlimited	✅
OAI	Any OpenAI-compatible	Varies	✅
Static	Manual config	N/A	✅

🚀 Quick Start

# Install
pip install freerouter

# Initialize configuration
freerouter init

# Edit config/providers.yaml with your API keys

# Fetch models and generate config
freerouter fetch

# Start the service
freerouter start

# List available models
freerouter list

📚 Documentation

• GitHub: https://github.com/mmdsnb/freerouter
• PyPI: https://pypi.org/project/freerouter/
• 中文文档: README_ZH.md

🔗 Links

• Package: https://pypi.org/project/freerouter/0.1.0/
• Repository: https://github.com/mmdsnb/freerouter
• Issues: https://github.com/mmdsnb/freerouter/issues

📝 Installation

pip install freerouter

Or from source:

git clone https://github.com/mmdsnb/freerouter.git
cd freerouter
pip install -e .

🙏 Acknowledgments

Built on top of LiteLLM - the amazing unified LLM API framework.