flask-ai-agent-studio

# Flask ChatBot: Multi-Provider + Tools + RAG + OCR + Multimodal + Canvas + Memory + Workspace

This is a single-page Flask chat application built around DeepSeek plus optional OpenRouter models, multi-step tool use, registry-driven composer slash commands, local RAG, dedicated local OCR, configurable helper/direct image analysis, conversation summarization, pruning, user-configurable entropy-aware context selection, persistent conversation memory, editable canvas documents, page-aware canvas navigation, and a per-conversation workspace sandbox.

It is not a minimal prompt/response demo. The app keeps conversation history in SQLite, restores assistant metadata when a conversation is reopened, supports editing earlier user messages, streams tool progress and reasoning, can enrich a user turn with local OCR or extracted document text before the model sees it, and can compact older content with summaries and pruning.

## Screenshots

### Tool execution

![Tool execution](screenshots/Screenshot_2026-04-09_18-04-09.png)

### Long-term memory (RAG)

![Long-term memory (RAG)](screenshots/Screenshot_2026-04-09_18-05-21.png)

### Canvas view

![Canvas view](screenshots/Screenshot_2026-04-09_18-05-58.png)

### Settings page

![Settings page](screenshots/Screenshot_2026-04-09_18-07-19.png)

## Contents

- [What the app does](#what-the-app-does)
- [Screenshots](#screenshots)
- [Architecture overview](#architecture-overview)
- [Project structure](#project-structure)
- [Installation](#installation)
- [Configuration](#configuration)
- [Using the app](#using-the-app)
- [Available tools](#available-tools)
- [HTTP endpoints](#http-endpoints)
- [Data storage](#data-storage)
- [Development](#development)
- [Security and operational notes](#security-and-operational-notes)
- [Troubleshooting](#troubleshooting)
- [FAQ](#faq)
- [License](#license)

## What the app does

### Chat and conversation workflow

- Create, open, rename, and delete conversations
- Stream assistant output to the bro