A fancy web UI for gptme, built with lovable.dev.

An alternative to the minimal UI bundled with gptme.

• Chat with LLMs using gptme, just like in the CLI, but with a fancy UI
• Generate responses and run tools by connecting to your local gptme-server instance
• Read bundled conversations without running gptme locally (useful for sharing)

You can use your own gptme-server instance with the latest version of the web UI hosted at chat.gptme.org, use our upcoming managed service gptme.ai, or run it locally:

git clone https://github.com/gptme/gptme-webui
cd gptme-webui
npm i

# start the web UI at http://localhost:5701
npm run dev

# install gptme with pipx if you haven't already, including the server dependencies
pipx install 'gptme[server]'

# start a gptme-server at http://localhost:5700, configured to allow requests from the web UI
gptme-server --cors-origin='http://localhost:5701'  # or whatever the origin of your local web UI is

Then open localhost:5701 in your browser.

This project is built with:

• Vite
• TypeScript
• React
• shadcn-ui
• Tailwind CSS

Available commands:

• npm run dev - Start development server
• npm run typecheck - Run type checking
• npm run typecheck:watch - Run type checking in watch mode
• npm run build - Build for production (includes type checking)
• npm run lint - Run linting and type checking

Run the test suite to ensure everything works correctly:

npm test                # Run all tests
npm run test:watch      # Run tests in watch mode
npm run test:coverage   # Run tests with coverage report
npm run test:e2e        # Run end-to-end tests with Playwright

The project includes unit tests for utilities and components, plus end-to-end tests for user workflows.

URL: https://run.gptengineer.app/projects/b6f40770-f632-4741-8247-3d47b9beac4e/improve