🤖 Ollama API Tools

Auto-execution CLI tool for LLM-powered task automation using local Ollama processing.

🎯 Purpose

This project enables automatic tool execution using local LLM processing. The LLM automatically:

Analyzes user requests and determines required tools
Executes tools automatically without manual intervention
Continues conversation with tool results
Handles simple tasks through focused tool usage

✨ Features

Auto-Execution: LLM automatically selects and executes tools
Local AI Processing: Uses Ollama for 100% local AI processing
Tool-Based Architecture: 8 specialized tools for automation
Interactive CLI: Inquirer-based command line interface
Context Management: Persistent conversation history and session management
Intelligent Tool Selection: LLM chooses appropriate tools automatically

🛠️ Tools Available

Tool	Description	Auto-Execution
`BashTool`	Execute bash commands securely	✅ Automatic
`GrepTool`	Search files with regex patterns	✅ Automatic
`GlobTool`	Find files using glob patterns	✅ Automatic
`ReadTool`	Read file contents	✅ Automatic
`EditTool`	Edit existing files	✅ Automatic
`WriteTool`	Create new files (restricted)	✅ Automatic
`LSTool`	List directory contents	✅ Automatic
`WebFetchTool`	Fetch web content	✅ Automatic

📦 Installation

# Clone the repository
git clone https://github.com/NeaByteLab/Ollama-API-Tools
cd Ollama-API-Tools

# Install dependencies
npm install

# Install Ollama (if not already installed)
# Visit: https://ollama.ai or https://ollama.com

⚙️ Prerequisites

Node.js 18+
Ollama running locally
Granite 3.2:8b model (or compatible model)

🚀 Usage

Start Auto-Execution Session

npm start
# or
node CLI.js

Show System Information

node CLI.js info

⚡ How Auto-Execution Works

User Input: You describe what you want
LLM Analysis: LLM analyzes request and selects tools
Auto-Execution: Tools execute automatically
Result Processing: Results are added to conversation
Continued Conversation: LLM responds with results

⚙️ Configuration

Default Model

Edit CLI.js line 40 to change the default model:

const defaultModel = 'granite3.2:8b' // Change this

Available Models

granite3.2:8b (default)
qwen2.5-coder:7b
llama3.2:8b
Any Ollama-compatible model

📝 Auto-Execution Examples

File Operations

# List directory contents
You: list files in current directory

# Read file contents  
You: read package.json

# Search for patterns
You: find all files containing "import"

# Edit files
You: add a comment to the main function

🔧 System Operations

# Check running services
You: check if redis is running

# Execute commands
You: run npm install

# System information
You: show system info

🌐 Web Operations

# Fetch web content
You: get content from https://example.com

🔄 Simple Workflows

# Basic file operations
You: read package.json and show dependencies

# Simple search
You: find all files containing "import" in src folder

🎯 Auto-Execution Features

Intelligent Tool Selection: LLM automatically chooses appropriate tools
Single Tool Execution: Simple, focused tool usage per request
Error Handling: Automatic error reporting and fallback
Context Awareness: Maintains conversation context across tool executions
Result Integration: Tool results automatically feed back into conversation

🛠️ Development

Project Structure

Ollama-API-Tools/
├── CLI.js              # Main CLI application with auto-execution
├── package.json        # Dependencies and scripts
├── prompt/            # AI prompt configurations
│   ├── prompt.txt     # Main system prompt
│   └── message.json   # Message templates
├── tools/             # Tool implementations
│   ├── Registry.js    # Tool registry
│   ├── BashTool.js    # Command execution
│   ├── ReadTool.js    # File reading
│   └── ...           # Other tools
├── services/          # Service layer
│   └── Provider.js    # Ollama API integration
├── utils/             # Utilities
│   └── Context.js     # Session management
└── tests/             # Test files
    └── TestTools.js   # Tool testing

➕ Adding New Tools

Create tool file in tools/ directory
Implement tool class with execute() method
Add to Registry.js exports
Update prompt.txt tool list

🧪 Testing

npm test
# or
node tests/TestTools.js

🔧 Troubleshooting

Common Issues

Ollama not running

# Start Ollama
ollama serve

Model not found

# Pull model
ollama pull granite3.2:8b

Tool execution errors

Check file permissions
Verify tool dependencies
Review error messages in console

Auto-execution not working

Check LLM model compatibility
Verify tool schema definitions
Review prompt configuration

📄 License

MIT License - NeaByteLab

GeezerVison

Latest commit

History

Folders and files

Repository files navigation