local-ai-utils-assist 0.2.4

No project description provided

Local AI Utils - Assist

A plugin for local-ai-utils, adding the ability to interact with an LLM Assistant. It is exposed as a CLI utility named assist, which can be sent a prompt. It also adds tool support that other LAIU plugins can tie in to.

Quickstart

Installation

Currently installation is only supported via the GitHub remote.

pip install local-ai-utils-assist

Configuration

Then update your ai-utils.yml file.

• assist.assitant is an OpenAI Assistant id
• assist.thread is an OpenAI Thread that has been started with the above assitant
• assist.mcp.servers takes a configuration block following the mcp-agent schema (it's functionally equivalent to Claude Code's format)
• assist.mcp.servers.[name].skip_confirmation allows you to list tools from that server that can be run without any confirmation.
• keys.openai is your Open AI secret key.

Usage

$ # Run once for new installs, and whenever new plugins are added
$ assist update_assistant
<outputs the configuration details of your assistant>


$ assist prompt "Make a note to call Joe"
OK, I've created a note to call Joe!

Configuration

These fields are required:

• assist.assistant
• assist.thread
• keys.openai

~/.config/ai-utils.yaml

plugins:
    assist:
        assistant: "asst_123"
        thread: "thread_321"
        mcp:
            servers:
                heroku:
                    command: npx
                    args: ["-y", "@heroku/mcp-server"]
                    env:
                        HEROKU_API_KEY: "HRKU-12345"
                    skip_confirmation:
                        - list_apps
keys:
    openai: "sk-proj-abc"

[!WARNING] There is a known bug right now that failed tool calls can leave a Thread in a broken state. If encountered, you will see errors referencing an inability to create new runs on threads that are in-progress. You can reset this by generating a new thread, and updating assist.thread in your ai-utils.yml.

Plugin Tools

When local-ai-utils-assist is installed, all other LAIU plugins can now make use of the functions keyword in their PluginConfig object. This key can be passed an array of objects matching the OpenAI Function Definition. See the notes plugin for an example.