Potpie

---

Table of Contents

• Overview
• Features
• Quick Start
• Development
  • Local Development Mode
  • Production Mode
• Contributing
• License

---

Overview

Potpie turns your entire codebase into a knowledge graph - a structural index of every file, class, and function, capturing all their relationships and what each part of the code does in context of everything else. AI agents built on this graph can reason about your code with the precision of someone who wrote it.

This repository contains the User Interface for the Potpie platform.

---

Features

Custom AI Agents Create agents tailored to your specific codebase from a single prompt.

Pre-Built Agents Choose from Debugging, Codebase Q&A, Code Generation, and Code Changes agents.

Chat Interface Easy-to-use chat with streaming support — interact with your agents in real time.

---

Quick Start

# 1. Clone the repository
git clone https://github.com/potpie-ai/potpie-ui.git
cd potpie-ui

# 2. Copy environment config
cp .env.template .env

# 3. Install dependencies and start
pnpm install
pnpm build
pnpm run dev

Open http://localhost:3000 in your browser.

---

Development

Local Development Mode

This project supports a local development mode — the app automatically detects missing configurations and falls back to mock implementations:

Service	Local Mode Behaviour
Firebase Authentication	Mock user with preset credentials (local-dev@example.com)
PostHog Analytics	No-op implementation — no data sent
Formbricks Bug Reporting	Disabled

How to Use Local Development Mode

1. Create a .env file without the following variables:

   • Firebase: NEXT_PUBLIC_FIREBASE_API_KEY, NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN, etc.
   • PostHog: NEXT_PUBLIC_POSTHOG_KEY, NEXT_PUBLIC_POSTHOG_HOST
   • Formbricks: NEXT_PUBLIC_FORMBRICKS_ENVIRONMENT_ID, NEXT_PUBLIC_FORMBRICKS_API_HOST

2. Run normally — the app detects missing config and uses mocks:

   pnpm run dev

3. You'll be automatically logged in as:

   • uid: local-dev-user
   • email: local-dev@example.com

Production Mode

For production, configure the following services:

Service	Purpose	Required
Firebase Authentication	User auth	✅ Yes
PostHog Analytics	Usage tracking	Optional
Formbricks	Bug reporting	Optional

Set your values in .env and run:

pnpm run build
pnpm start

---

Contributing

Contributions are welcome! Please read the Contributing Guide before submitting a PR.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

License

This project is licensed under the Apache 2.0 License — see the LICENSE file for details.