Skip to content

Repository files navigation

doota-logo

Doota (pronounced Dhoo-tha / Dhūta / Dhootha) comes from the Sanskrit and Kannada word दूत / ದೂತ, meaning messenger, envoy, or agent — someone that carries information, executes tasks, and acts on behalf of another.

Doota is agentic system for Ollama with built-in tools and an autonomous agent loop to power your private AI ecosystem.
GitHub Release

Requirements

Download and Run

Find the latest release here and download the .jar file. Then, run the following command:

java -jar /path/to/doota-<version>-runner.jar

Chat with model selection

Doota - Meaning

Agentic conversation

Doota - Agent

Features

🤖 Autonomous Agentic Chat Loop

  • Client-Driven Reasoning: A fully autonomous agentic loop running directly in the browser (supporting up to 10 iterations per request).
  • Dynamic Decision Making: The LLM autonomously determines when to execute tools, sequences multiple tool calls dynamically, and compiles final answers.
  • Live Status Diagnostics: Visually track the step-by-step thinking process (e.g., "Thinking...", "Asking the model...", "Executing tool: x...").
  • Performance Metrics: Real-time generation statistics featuring live tokens-per-second (TPS) metrics.

🔌 Interactive Tool Execution & Inspection

  • Live Tool Status: Status states with beautiful visual cues for Pending (⏳), Running (⚙️), Success (✅), and Error (❌) executions.
  • Collapsible Details: Accordion cards display parsed JSON arguments, execution time, and raw results for every tool invoked.
  • Error Resilience: Robust system-level and LLM-level error handling ensuring stable execution of sequential tool logic.

🛠️ Built-in Agent Tools (Out-of-the-box)

  • Filesystem & Search:
    • find_files_by_name: Recursively searches files across a chosen directory (defaults to home directory) using keyword/substring search.
    • find_files_by_extension: Recursively locates files matching specific file formats (e.g., .java, .pdf, .png).
    • read_file: Safe retrieval of text-based file contents.
    • get_home_directory: Resolves the absolute path of the user's home directory.
  • System Diagnostics & Environment:
    • system_info: Inspects system hardware details, including OS name/version, CPU cores, JVM memory capacity, and drive storage sizes.
    • platform_type: Safely identifies the operating system family (mac, windows, or linux).
  • General Utilities:
    • calculator: Safe mathematical expression evaluator supporting basic and complex arithmetic.
    • get_current_datetime: Queries the real-time system date and time.
    • get_weather: Location-based weather report function.

📊 Advanced Model Management

  • Search, Filter & Sort: Easily query models via name, family, parameter size, or quantization level. Sort lists by name, file size, or modified date.
  • Detailed Specifications: Hover and view comprehensive metadata cards detailing model family (e.g., Llama, Mistral, Qwen), parameter sizes, and quantization.
  • Memory Management: Polls loaded models in real time; allows one-click unloading to release system RAM, or permanent deletion from disk.

⚙️ Real-time Settings & Connection Diagnostics

  • Custom Host URL: Seamlessly configure custom Ollama URLs (e.g., http://localhost:11434 or remote setups) in a dedicated settings view.
  • Heartbeat & Polling: Active background pings (every 3 seconds) verify host connection health and show a live server reachability status.
  • Live Polling: Programmatic loaded-model checks (every 1 second) keep the UI perfectly in sync with Ollama's active memory usage.

💾 Local Chat Persistence & UX Polish

  • Local Persistence: Conversations are automatically persisted as JSON files under your home directory (~/doota/chats), preserving full multi-turn context.
  • Premium Theme: Modern dark-themed user interface styled with premium layouts and powered by smooth hover animations.
  • Vibrant Details: Clean Markdown rendering (with full GFM support), code highlighting, simple sidebar navigation, and quick copy-to-clipboard buttons.

Untitled design (6) Untitled design (5) Untitled design (4) Untitled design (3) Untitled design (2) Untitled design (1)

⭐ Give us a Star!

If you like or are using this project to build your own, please give us a star. It's a free way to show your support.

Appreciate the work?

Buy Me A Coffee

About

An agentic system for Ollama — autonomous agents, built-in tools, your local/private AI stack.

Topics

Resources

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages