RAG Agent

A minimal example project containing a simple agent architecture and a web UI. The agent is implemented in Python, while the frontend is built with Next.js.

Overview

This repository demonstrates a simple agent architecture (in the backend/ folder) alongside a web UI (in the frontend/ folder). It includes tests for the Python agent and basic components for the frontend.

Requirements

• Python 3.11+ (for the agent)
• pip or uv for Python package management
• Node.js 18+ (for the web frontend)
• pnpm or npm for JavaScript package management

Install

Python (agent):

cd backend
uv sync # or `pip install -r requirements.txt` if you don't use uv

Web frontend:

cd frontend
pnpm install # or `npm install` if you don't use pnpm

Run

Run the agent (from the backend folder):

cd backend
uv run main.py # or `python -m main` if you don't use uv

Run the frontend (from the frontend folder):

cd frontend
pnpm dev # or `npm run dev`

Project structure

• backend/ — Python agent source and configuration
• frontend/ — Next.js frontend and components

Contributing

Contributions welcome. Open an issue or create a pull request with a clear description of changes.

License

This project is provided as-is. Add a license file if you wish to clarify usage terms.