Skip to main content

A command-line interface for Ollama API

Project description

mdllama

A CLI tool that lets you chat with Ollama models right from your terminal, with built-in Markdown rendering.

mdllama makes it easy to interact with Ollama's AI models directly from your command line, meanwhile providing you with real-time Markdown rendering

Features

  • Chat with Ollama models from the terminal
  • Built-in Markdown rendering
  • Simple installation and removal (see below)

Screenshots

Chat Interface

Chat

Help

Help

Demo

Note: If the video does not play, you can download it here.

Installation

Install using package manager (recommended)

Debian/Ubuntu Installation

  1. Add the PPA to your sources list:
    echo 'deb [trusted=yes] https://packages.qincai.xyz/debian stable main' | sudo tee /etc/apt/sources.list.d/qincai-mdllama.list
    sudo apt update
    
  2. Install mdllama:
    sudo apt install python3-mdllama
    

Fedora Installation

  1. Download the latest RPM from: https://packages.qincai.xyz/fedora/

    Or, to install directly:

    sudo dnf install https://packages.qincai.xyz/fedora/mdllama-<version>.noarch.rpm
    

    Replace <version> with the latest version number.

  2. (Optional, recommended) To enable as a repository for updates, create /etc/yum.repos.d/qincai-mdllama.repo:

    [qincai-mdllama]
    name=Raymont mdllama RPMs
    baseurl=https://packages.qincai.xyz/fedora/
    enabled=1
    gpgcheck=0
    

    Then install with:

    sudo dnf install mdllama
    

Traditional Bash Script Installation (Linux)

To install mdllama using the traditional bash script, run:

bash <(curl -fsSL https://raw.githubusercontent.com/QinCai-rui/mdllama/refs/heads/main/install.sh)

To uninstall mdllama, run:

bash <(curl -fsSL https://raw.githubusercontent.com/QinCai-rui/mdllama/refs/heads/main/uninstall.sh)

Windows & macOS Installation

Install via pip (recommended for Windows/macOS):

pip install mdllama

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mdllama-2.0.0.tar.gz (51.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mdllama-2.0.0-py3-none-any.whl (39.3 kB view details)

Uploaded Python 3

File details

Details for the file mdllama-2.0.0.tar.gz.

File metadata

  • Download URL: mdllama-2.0.0.tar.gz
  • Upload date:
  • Size: 51.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mdllama-2.0.0.tar.gz
Algorithm Hash digest
SHA256 b204f209d80a5dada06d4ddc9c24ebdef7495079a6a0b369dc9092edc6b9d275
MD5 6d0eac63b72d5d526a03f32b6889c11f
BLAKE2b-256 158cba2c0578ca4cbc777e5021117b5dacabf1924e8ff7ae787daba4ce0facca

See more details on using hashes here.

Provenance

The following attestation bundles were made for mdllama-2.0.0.tar.gz:

Publisher: publish-to-pypi.yml on QinCai-rui/mdllama

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mdllama-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: mdllama-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 39.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mdllama-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 00f4efb1a96f6d4962ad1f3033a9b4c7cecfac0d17b6703a3f992e97ac8d905e
MD5 eaea912d89a7e2d9a21ee69b8da2758b
BLAKE2b-256 8eda7f65da751a7be5fbd2d5fc12bb3579b669161f23a350ff65c0d19be49d9a

See more details on using hashes here.

Provenance

The following attestation bundles were made for mdllama-2.0.0-py3-none-any.whl:

Publisher: publish-to-pypi.yml on QinCai-rui/mdllama

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page