Instrukt

Instrukt is a terminal app for developers who want to build and test AI agents on their own machine or server. It can index local code and documents, but its chat models run through OpenAI's API, which requires an API key and internet access. It doesn't provide local chat inference.

The included coding assistant answers questions using an attached codebase index, while a conversational agent handles general Q&A. Agents are Python packages you can extend and share, with custom tools and document indexes attached to them. LangChain supplies the agent and tool framework.

Chroma manages the document indexes. Indexing detects programming languages and splits source files accordingly, and you can inspect the documents retrieved for an answer. Embeddings can use OpenAI or local models, including SentenceTransformers and Instructor Embeddings. Choosing local embeddings keeps that indexing step on your hardware; chat requests still go to OpenAI.

The keyboard and mouse interface displays Markdown and source code. Prompt history and external editors such as Vim or Emacs support longer conversations, while a prompt console and embedded IPython console help developers test and inspect agent behavior.

Instrukt is open source under AGPL-3.0. It runs on Linux and macOS, supports Windows through WSL2, and is accessible on headless servers over SSH. Agents can execute tasks in Docker containers, with gVisor available for additional isolation.