Skip to content
This repository was archived by the owner on Jun 2, 2025. It is now read-only.

cmdecker95/agent-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Agent Template

A template for building agent-based applications that interact with LLMs through Ollama and with tools/resource through MCP

Overview

Agent Template provides a framework for running a UI that can interact with a locally-hosted Language Learning Model (LLM) using Ollama. This system allows the LLM to make decisions and execute workflows based on user inputs and available tools.

The template implements a Model-Control-Protocol (MCP) client architecture, designed to interact with a future "api" service using FastMCP to expose API function calls as MCP tools.

Features

  • UI interface for interacting with LLM agents
  • Integration with Ollama for local LLM hosting
  • MCP client implementation for structured communication
  • Workflow execution framework
  • Extensible tool system

Architecture

The system consists of:

  1. UI Layer: User interface for agent interaction
  2. MCP Client: Handles communication protocol with LLMs
  3. Ollama Integration: Connects to locally-hosted LLM
  4. Workflow Engine: Executes sequences of actions
  5. Tool System: Expandable set of capabilities for the agent

Getting Started

Prerequisites

  • Ollama installed and configured
  • Docker and Docker Compose
  • Node.js and npm for development

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/agent-template.git
    cd agent-template
  2. Start the application using Docker Compose:

    docker-compose up

Future Development

  • API Service: A Python FastAPI server using FastMCP to wrap API function calls as MCP tools
  • Enhanced workflow capabilities
  • Additional tool integrations
  • Improved agent reasoning capabilities

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

👽 A template for building agent-based applications that interact with LLMs through Ollama and with tools/resource through MCP

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors