oaicli 0.1.0

A Command Line Interface to Open AI

OAICLI 🕶️

A Command Line Interface to Open AI (pronounced Oakley (IPA oʊk.li), like the sunglasses)

OAICLI is designed to help developers test, create, and use assistants, which were launched on OpenAI Dev Day, November 2023.

Threads, messages, and message runs are abstracted, so make the user experience more seamless. If runs reach a time limit, they will be canceled.

Use at your own risk. I built this for myself, but feel free to open issues and PRs.

If you want a complete implementation of what Assistants are capable of, you can use the friendly OpenAI playground.

installation

pip install oaicli

Next, creat an .env file with

OPENAI_API_KEY  = "[your key]"
OPEN_AI_MODEL_TYPE = "gpt-4-1106-preview"
OPEN_AI_VISION_MODEL_TYPE = "gpt-4-1106-vision-preview"

On first run, oaicli installs a directory in the project location

/oaicli/agent/agents.yaml (agent names-> ids)
/oaicli/agent/[agent id]/instructions.yaml
/oaicli/threads/threads.yaml (thread names-> ids)
/oaicli/threads/[thread id]/[message id].txt
/oaicli/files/[file id]/[filename]

The above directory structure should let you check in your work to your code repository and track changes.

Agents and threads are given names to make it easier Files can be added to conversation.

Commands

oaicli -h | --help for help

Threads are stored in append only textfiles.

• oicli start - allows you to start up, choose a thread by name

Roadmap

v0.2

• oaicli thread.list [agent] lists current threads
• oaicli thread.join [agent] [thread choice from thread.list]
• oaicli thread.new [agent] [thread title] - stored locally matched to thread id

Maintanence functions

• oaicli agent.list - list agents
• oaicli agent.create [agent name] - create a new agent
• oaicli agent.edit [agent] [prompt | name | params] - edit something about the agent
• oaicli agent.delete [agent] - delete an agent (don't be mean)
• oaicli agent.file-upload [agent] [path] - send a file to your agent
• oaicli agent.directory-upload [agent] [path] - takes all text files and pdf files and uploads content
• oaicli agent.url-upload [agent] [URL]
• oaicli agent.file-list [agent] - list an agents files

v0.3

• agent.dialog [agent name one] [agent name two] ... - have agents talk to eachother ala autoGPT
• agent.local-rag [agent] - add a file to local rag for use with an agent
• agent.function [agent] - add a file to local rag for use with an agent
• pydantic, mypy for typing
• tox and testing

v0.4

• shell completion for commands and directories and files (clicko?)
• SQL lite for RAG and storage
• tools support https://platform.openai.com/docs/api-reference/assistants/createAssistant#assistants-createassistant-tools

Development

pyenv install 3.12
pyenv virtualenv 3.12 oaicli
export PYTHONPATH="[project path]/oaicli
pip install .