Skip to main content

Add your description here

Project description

Herder

A terminal chat utility for Ollama providing MCP support.

You need Ollama installed for this utility.

Screenshot

This also supports running without an input prompt, which makes scheduling a task easy with crons.

# uv run main.py --prompt 'What is my name.' --history-file history.log --no-banner
  User (2025-08-04T21:24:11.752604):
What is my name.

  Assistant (2025-08-04T21:24:11.752625):
I'm sorry, but I don't have access to personal information about users, including names. Is there something else I can help you with?

# uv run main.py --prompt 'We are doing a memory test. The name is Sam.' --history-file history.log --no-banner
  User (2025-08-04T21:24:18.671558):
We are doing a memory test. The name is Sam.

  Assistant (2025-08-04T21:24:18.671572):
Thank you for letting me know! If you have any other questions or need assistance with anything else, feel free to ask.

# uv run main.py --prompt 'What was my name?' --history-file history.log --no-banner
  User (2025-08-04T21:24:24.214079):
What was my name?

  Assistant (2025-08-04T21:24:24.214095):
Your name is Sam.

Working Features

  • Chatting with Ollama models.
  • MCP server configuration.
  • Tool calling.

Features in Progress

  • Tool call approval confirmation.
  • Autoapprove options/configuration.
  • Default tools: Sandboxed file access, Command calling
  • Automatic context compaction.

Nice Haves

  • Would be great to figure out how to support shrinking the message box on terminal resize.

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

herder_cli-0.1.4.tar.gz (16.7 kB view details)

Uploaded Source

Built Distribution

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

herder_cli-0.1.4-py3-none-any.whl (17.3 kB view details)

Uploaded Python 3

File details

Details for the file herder_cli-0.1.4.tar.gz.

File metadata

  • Download URL: herder_cli-0.1.4.tar.gz
  • Upload date:
  • Size: 16.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.8

File hashes

Hashes for herder_cli-0.1.4.tar.gz
Algorithm Hash digest
SHA256 952176a9d2cf0c5ddf58fa3ae328f5b92247f5929e5feb2a61bbbc0359e331d8
MD5 21848e24cf76adddf7197db1e864b164
BLAKE2b-256 29d22bd76bd5969b24d8126d8a81640a37b127c433e9808f0056b9f5e399afc4

See more details on using hashes here.

File details

Details for the file herder_cli-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for herder_cli-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 1924d860805476acac7031936ff232c6f497274a162310005a414697131acc03
MD5 7b0a18cc3f9471ed4fd006ece1b2bcac
BLAKE2b-256 6bddd723717b1912a474b830877ab2ec7e9fd52946e12c5dc4db0ca4037c1f58

See more details on using hashes here.

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