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="acatome", cmd=["uv", "run", "acatome-mcp"]),
        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.0.tar.gz (26.6 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.0-py3-none-any.whl (25.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for acatome_lambic-0.5.0.tar.gz
Algorithm Hash digest
SHA256 d3beb80aee28a03981a34c210d4224d4bb7aae76cf654489e58e64e31ee75723
MD5 fb781cb4b3091c047a18584bc06f2136
BLAKE2b-256 3701927078db7df0a2e673ca02397d65e4d06fd0279f1b110830168fdc91c70d

See more details on using hashes here.

Provenance

The following attestation bundles were made for acatome_lambic-0.5.0.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.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for acatome_lambic-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ebe74cfb0781d30cec5568f86e21d52a28ddc98b780e3ab06e37137dbb9000b4
MD5 232cccc7eef2275fa405bd9c897a20c7
BLAKE2b-256 d2138ba7343d39d002855f48e2341583014db68f5c185a292d53b0d5cb59c058

See more details on using hashes here.

Provenance

The following attestation bundles were made for acatome_lambic-0.5.0-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