flexigpt-app

README

FlexiGPT

FlexiGPT is a local-first AI workflow workspace for power users and teams who need repeatable prompts, tools, skills, model choices, assistants/agents, and private local history across multiple LLM providers.

Who FlexiGPT is for

FlexiGPT is built for people who use LLMs as part of repeatable work, not just one-off chat.

• Power/Local-first users who want provider choice, private local history, and full control over configuration and orchestration.
• Developers and technical writers who reuse assistants/agents, prompts, attachments, tools, and model setups.
• Consultants and small teams who want consistent assistant workflows without sending chat history through another hosted app.

Install

1. Download the latest release from GitHub Releases
   • macOS: .pkg, Linux: .flatpak, Windows: .exe
2. Install the package. Detailed installation steps are here
3. Launch FlexiGPT

Quick start

• Get an API key for your provider.
  • OpenAI, Anthropic Claude, Google Gemini, xAI, MistralAI
  • OpenRouter, Hugging Face
• Add the key in Settings -> Auth Keys.
• Chat. Start from a built-in assistant preset or build your own reusable workflow with prompts, attachments, tools, and skills.

Good first workflows:

• Open the app home screen and choose a starter workflow card such as Code Review, Explain This File, Generate Docs, Research Summary, Architecture Review, or Bug Investigation.
• Attach the relevant file, folder, notes, PDF, URL, or code snippet.
• Send the prefilled prompt as-is or adjust it for your task.
• Reuse or customize the assistant preset once the workflow fits your style.

FlexiGPT does not bill you directly. Usage costs and limits come from the provider account behind the key you configure. FlexiGPT does not proxy normal LLM calls through a FlexiGPT-hosted service; requests go directly to the provider or compatible endpoint you configure.

Screenshots

All images are here

Key features

Provider-independent model choices with built-in presets

• First-class built-in support for OpenAI, Anthropic, Google Gemini API, xAI, Mistral, Hugging Face, OpenRouter, and local llama.cpp
• Support for compatible custom endpoints across OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, and Google GenerateContent style APIs
• Built-in providers and curated model presets for leading models so you can start quickly without manually defining endpoints or defaults first
• API keys are stored securely through the OS keyring, not in plain-text exported settings

Repeatable AI workflow workspace

• One interface for chats, tabs, reusable assistant presets, model presets, prompt templates, attachments, tools, skills, search, and exports
• Build repeatable workflows by combining model choices, instructions, attachments, tools, and skills
• Switch providers or models as you iterate
• Multi-tab conversations with local history search and resume flows
• Export the current conversation as JSON

Assistants, tools, and agentic workflows with human-in-loop controls

• Assistant presets bundle model choice, instructions, tools, and skills into reusable starting setups
• Tools can be attached per conversation and configured for manual review or auto-execution
• When an auto-execute tool is called, FlexiGPT can run it and automatically submit the result back to the model, enabling assistant/agent-style workflows inside a normal chat flow
• Keep tools manual when you want tighter control over execution

Rich response rendering and inspection

• Markdown rendering with syntax-highlighted code blocks
• Mermaid diagram rendering with zoom and source or image export workflows
• KaTeX math rendering
• Citations, token usage, and per-message request/response details for inspection and debugging
• Message-level controls for copying, inspection, and follow-up iteration

Private local context and history

• Local conversation storage and full-text search
• File, folder, image, PDF, and URL attachments
• Bundled offline docs shipped inside the app
• Conversations, workflow catalogs, and configuration are stored locally; selected request context is sent to the provider or endpoint you choose when you send.
• Use your own provider accounts; FlexiGPT does not proxy or bill model usage.

Documentation

Repository-only install notes

• Installation

Bundled in-app user guide

• Getting Started
• Core Concepts
• Chats, Composer, and Everyday Workflow
• Attachments, Tools, Skills, and Prompts
• Presets, Providers, and Settings
• Storage, Data Control, and Troubleshooting
• Security, Privacy, and Trust Model
• Recipes and Starter Workflows
• Provider and Local Model Setup

Bundled in-app architecture reference

• Architecture Overview
• Backend Roles and Responsibilities
• Frontend Roles and Responsibilities
• Chats Workspace and Composer Design

Built with

• Data storage: JSON and SQLite files in local filesystem.
• Go backend.
• Wails as a desktop application building platform.
• Official Go SDKs by OpenAI, Anthropic, and Google GenAI.
• Vite + React Router v7 frontend in Typescript. DaisyUI with TailwindCSS for styling.
• Tooling: Golangci-lint, Knip, ESLint, Prettier, GitHub actions

Contributing

Developer setup is documented in: devsetup.md

License

Copyright (c) 2024 - Present - Pankaj Pipada

All source code in this repository, unless otherwise noted, is licensed under the Mozilla Public License, v. 2.0. See LICENSE for details.