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.1.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.1-py3-none-any.whl (39.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mdllama-2.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 10fc3eeabfd32ef721b4f06e8f2e4d6006dca6155fea1735aee709af5a0dd93e
MD5 ebe98a1605f93f09135ee8c80496f1fd
BLAKE2b-256 537b0db9c200d2cfcc389ce8f747c26dd05695a9e10cb326a665332e3d176004

See more details on using hashes here.

Provenance

The following attestation bundles were made for mdllama-2.0.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: mdllama-2.0.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 dfedbbf3f7821207e39cf9cedaaef88573b6cf197058abe3c932ca4d22f65c39
MD5 3c995306f719bfa7ea7794c4f9c8a905
BLAKE2b-256 c1bff6cc61c79709ecbfabcfe382a32492c0a651f958a5c2193d157e207f2846

See more details on using hashes here.

Provenance

The following attestation bundles were made for mdllama-2.0.1-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