Skip to main content

Language Model Terminal Interface.

Project description

Language Model Terminal Interface

Often I just want to talk to LMs without the agentic clutter: I dont want it to read my stuff, access my files or consume through a gazillion tokens of tools, skills, MCPs and what not. I just want a recipe for gazpacho, c'mon :(

For that, I normally have to log into a WebApp from a provider (i.e. Mistral LeChat, Gemini, ChatGPT). But I live on the terminal, so I made a thin wrapper.

assets/demo.gif

If somehow you landed here but you are looking for an actual agent that can manage your system, I'd recommend you look into pi, opencode or mistral-vibe (in that order). If your desire is to become vendor locked and further push private companies in their quest for the oligopoly, you could check Claude Code or Codex, I guess :)

FAQ

  • Can I talk with LMs from different providers from the terminal? - Yes :)
  • Does the app have access to my files? - No
  • Can the app run terminal commands? - Nope
  • Can the app execute code? - Nein
  • Does the app have any sort of agentic loop? - Negative
  • Can I connect the app to MCPs or other tools? - Also no

Installation

uv tool install lmti

Usage

# Start with the default model
lmti

# Start with a specific model
lmti -m vertex:gemini-2.5-flash

lmti does support several commands to reset a conversation, undo some message, change models, etc. Simply type forward slash (/) while on the REPL to see a list of supported actions.

Config

Config is stored at ~/.config/lmti/config.yaml. It handles your credentials and default settings. Many of these can also be modified through commands in the TUI:

credentials:
  MISTRAL_API_KEY: your-key-here
settings:
  render_markdown: true
  model: mistral:mistral-small-2603
models:
- mistral:mistral-small-2603
- vertex:gemini-2.5-flash

Development

Structure

src/lmti/
├── cli.py      # Argument parsing and entry point
├── config.py   # Configuration management
├── errors.py   # Error handling
├── repl.py     # Main REPL loop logic
├── ui.py       # Terminal UI (prompt-toolkit and rich)
├── commands/   # Slash command implementations
└── __init__.py

Tooling

We use just for development tasks. Use:

  • just sync: Updates lockfile and syncs environment.
  • just format: Lints and formats with ruff.
  • just check-types: Static analysis with ty.
  • just check-complexity: Cyclomatic complexity checks with complexipy.
  • just test: Runs pytest with 90% coverage threshold.

Contribute

  1. Hooks: Install pre-commit hooks via just install-hooks.
  2. Issues: Open an issue first using the default template.
  3. PRs: Link your PR to the relevant issue.

License

MIT

Done with mold template

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

lmti-1.5.0.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

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

lmti-1.5.0-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

Details for the file lmti-1.5.0.tar.gz.

File metadata

  • Download URL: lmti-1.5.0.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for lmti-1.5.0.tar.gz
Algorithm Hash digest
SHA256 57a26d26c29f6d5106b2e7ded035f2a62ed28a737e6c01faa54bf1bf6919f2f2
MD5 9f2991d53fbb23c23cf28650988cd9d3
BLAKE2b-256 cd9d765dca2dcb58a0944a74f364a7d2c0002e7b3a6a602e6fb822d5b2949da1

See more details on using hashes here.

File details

Details for the file lmti-1.5.0-py3-none-any.whl.

File metadata

  • Download URL: lmti-1.5.0-py3-none-any.whl
  • Upload date:
  • Size: 16.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for lmti-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c87b7f9930f9017b39cfc225d718969f503da4e105451b43980956b290409d06
MD5 1266f40ecb5890e65f2dd1a6ccd0cb69
BLAKE2b-256 9d1d79e46447fda619f31c02e622537bbe5f832ba28841d434b8c6ed5631cbe8

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