ORCA is a command-line interface application that allows you to search, explore, and download models from the Ollama Registry. It provides an intuitive interface for discovering models, viewing their tags, and pulling them to your local Ollama installation.
- Search the Ollama Registry for models
- View available tags for models
- Pull models directly to your local Ollama installation
- Open model pages in your browser for more information
You will need Python 3.10 installed.
pip install orca-cli
Then you can call the tool via the orca-cli command
>orca-cli
Usage: orca-cli [OPTIONS] COMMAND [ARGS]...
╭─ Options ────────────────────────────────────────────────────────────────────────╮
│ --install-completion Install completion for the current shell. │
│ --show-completion Show completion for the current shell, to copy it │
│ or customize the installation. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────╮
│ search Searches the Ollama Registry for a model. │
│ download Downloads a model from Ollama Registry to the specified location. For │
│ example the following command downloads llama3.2:1b as model.gguf to │
│ the current working directory.: `orca-cli llama3.2 1b model.gguf .` │
╰──────────────────────────────────────────────────────────────────────────────────╯
ORCA provides the following commands:
orca-cli search [QUERY]
If no query is provided, you'll be prompted to enter a search term interactively.
Example:
orca-cli search gemma3
orca-cli download [MODEL_NAME] [TAG] [FILE_NAME] [DIRECTORY]
- Downloads a specific model tag to the specified file and directory.
- If the Ollama Registry contains an adapter alongside the base model, orca-cli will override the given filename and add
-base
and-adapter
postfixes to the filename.
Example:
orca-cli download llama3.2 1b model.gguf .
- Python 3.10 or higher
- Ollama installed on your system
-
Clone the repository:
git clone https://github.com/molbal/orca.git cd orca
-
Create virtual environment if you want, then install the required dependencies:
pip install -r requirements.txt
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/new-feature
) - Commit your changes (
git commit -m 'Add some new feature'
) - Push to the branch (
git push origin feature/new-feature
) - Open a Pull Request
This project is licensed under the Apache - see the LICENSE file for details.
- Ollama, obviously
- All the open-source projects that make ORCA possible
ORCA is not officially affiliated with Ollama.