Skip to main content

MCP-aware LLM shell with provider switching

Project description

acatome-lambic

MCP-aware LLM shell with provider switching.

Connects to MCP servers via stdio, talks to LLMs (ollama, OpenAI, Anthropic via litellm), and provides a terminal chat interface with tool calling.

Usage

from acatome_lambic.tui.app import Shell
from acatome_lambic.core.config import LlmConfig, McpServer, ShellConfig

config = ShellConfig(
    llm=LlmConfig(provider="ollama", model="qwen3.5:9b"),
    servers=[
        McpServer(name="precis", cmd=["uv", "run", "precis"]),
    ],
    system_prompt="You are a research assistant.",
)
Shell(config).run()

Commands

  • /model <provider/model> — switch LLM
  • /think on|off — toggle reasoning mode (default: on)
  • /tools — list tools with on/off status
  • /tools off <pattern> — disable tools matching pattern
  • /tools on <pattern> — enable tools matching pattern
  • /expand <call_id> — show full (untruncated) tool result
  • /status — show session info
  • /clear — clear message history
  • /help — show command help
  • /quit — exit

Applications can register custom commands (custom_commands) and LLM-routed message commands (message_commands) via ShellConfig. All registered commands appear in tab autocomplete.

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

acatome_lambic-0.5.4.tar.gz (30.3 kB view details)

Uploaded Source

Built Distribution

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

acatome_lambic-0.5.4-py3-none-any.whl (26.2 kB view details)

Uploaded Python 3

File details

Details for the file acatome_lambic-0.5.4.tar.gz.

File metadata

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

File hashes

Hashes for acatome_lambic-0.5.4.tar.gz
Algorithm Hash digest
SHA256 efc65439ce8801de92688ef1466244dbf71986aba93395b3c261bda0f29af66b
MD5 d6b50af50274b676643bf69ecafddba2
BLAKE2b-256 69820e7dee75fed2b53383a55f5a3c657f7546c0cb86a4c707238d61d9fb53f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for acatome_lambic-0.5.4.tar.gz:

Publisher: publish.yml on retospect/acatome-lambic

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

File details

Details for the file acatome_lambic-0.5.4-py3-none-any.whl.

File metadata

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

File hashes

Hashes for acatome_lambic-0.5.4-py3-none-any.whl
Algorithm Hash digest
SHA256 afc0e62be862e34aa8d60ef9ee42d13729d0e025bef36bf7d37794925a8877ec
MD5 b218ee04779bf0e9deea0139b92e93eb
BLAKE2b-256 8b26c75da42256cc6872cef0994f3f6a621c2c7def15e75b5c15927c8099fe5b

See more details on using hashes here.

Provenance

The following attestation bundles were made for acatome_lambic-0.5.4-py3-none-any.whl:

Publisher: publish.yml on retospect/acatome-lambic

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