Skip to content

Home

Jump to bottom
Doruk Kahraman edited this page Mar 19, 2026 · 1 revision

Welcome to the OllamaCode Wiki

OllamaCode is a powerful tool that transforms your terminal into an intelligent autonomous assistant. It helps you manage your system by utilizing both local (Ollama) and cloud-based (Groq) AI models.

In this wiki, you will find detailed information about how to install, configure, and use OllamaCode effectively.

Key Features

OllamaCode is not just a chatbot; it is an agent that can interact with your system:

  • Hybrid Model Support: Use ultra-fast cloud models from Groq (such as Llama 3.3) or completely local and private models via Ollama.
  • Autonomous Command Loop (Agentic Loop): Define a task, and OllamaCode will generate the necessary commands, run them with your approval, and analyze the results to determine the next steps.
  • Hardware Monitoring: View real-time CPU, RAM, and Disk usage at the bottom of your terminal to keep track of your system status.
  • Rich User Interface: Powered by the rich library, enjoy a stylish terminal experience with tables, panels, and Markdown support.
  • Smart Error Correction: If a command fails, OllamaCode reads the error output and automatically suggests solutions or fixes.

Quick Start

You can set up and start using OllamaCode in seconds.

  1. Installation Clone the repository and install the package: git clone https://github.com/drkkahraman/ollamacode.git cd ollamacode pip install .

  2. Running Simply type the command: ollamacode

  3. First-Time Configuration On the first run, a setup wizard will guide you:

  • Select your AI provider (Groq or Ollama).
  • If you choose Groq, enter your API key.
  • Select your preferred model from the generated list.

Wiki Contents

  • Installation Guide: Detailed installation steps.
  • Configuration Settings: .ollamacode_settings.json and API key management.
  • Model Management: Differences between Ollama and Groq models.
  • Frequently Asked Questions (FAQ): Common issues and their solutions.

Tip You can reset the chat history by typing /clear or update the tool to the latest version by typing /update (or update) within OllamaCode.

Tip: To get better results, define specific tasks such as "List all .py files in this folder and analyze the largest one."

Clone this wiki locally