LocalAgent

A simple AI agent server that can respond to questions and interact with local measurements data.

Prerequisites

• Python 3.13 or higher
• uv - Fast Python package installer and resolver

Setup

1. Clone this repository:

   git clone <repository-url>
   cd localagent
   

2. Create a virtual environment using uv:

   uv venv
   

   This creates a virtual environment in the .venv directory.

3. Activate the virtual environment:

   On macOS/Linux:

   source .venv/bin/activate
   

   On Windows:

   .venv\Scripts\activate
   

4. Install dependencies using uv:

   uv pip install -e .
   

   This will install all required dependencies including:

   • fast-agent-mcp
   • FastAPI
   • uvicorn

Running the Server

Start the server using uvicorn:

uvicorn agent-server:app --host 0.0.0.0 --port 8999

This will start the server on all network interfaces (0.0.0.0) on port 8999.

Usage

API Endpoints

POST /ask

Send questions to the agent:

curl -X POST http://localhost:8999/ask \
  -H "Content-Type: application/json" \
  -d '{"question": "Your question here"}'

Running in Interactive Mode

You can also run the agent in interactive mode:

python agent.py

Configuration

The agent uses configuration files for setup, but you'll need to create your own based on your specific needs.