Local Setup
Follow this detailed guide to set up your local development environment for Proxed.AI. Covers project structure, prerequisites like Bun and Docker, cloning the repository, installing dependencies, and running the project.
Local Setup
Proxed.AI is a monorepo that uses TurboRepo.
Project Structure
apps
├── api
├── app
├── docs
├── web
packages
├── analytics
├── jobs
├── kv
├── location
├── logger
├── mail
├── notifications
├── structure
├── supabase
├── ui
├── utils
tooling
├── typescriptThe apps directory contains the core applications and services that need to be run.
api: The core API proxy service built with Hono on Bun.app: The Next.js portal that is used to manage the Proxed.AI platform.docs: The documentation site that is built with Fumadocs.web: The Next.js marketing site.
The packages directory contains the shared code that is used across the project.
analytics: The analytics service that is built with Openpanel.jobs: Background jobs powered by Trigger.dev.kv: Key-value storage utilities.location: The location specific utilities.logger: The logger service that is built with Pino.mail: The mail service that is built with Resend.notifications: Notification helpers and integrations.structure: The visual schema builder.supabase: Supabase client, queries, and database config.ui: The UI components that are built with Shadcn/UI.utils: The utility functions that are used across the project.
The tooling directory contains the tools and scripts that are used to build and run the project.
typescript: The TypeScript configuration.
Prerequisites
- Bun
- Docker
- Supabase
Setup Steps
- Clone the repository
git clone https://github.com/nech-ai/proxed.git- Install dependencies
bun install- Create a
.envfile in the root of the project
cp .env.example .env- Run the project
bun devVault for Generated Images
Save generated images to the Vault, keep them attached to executions, and manage them in the dashboard.
Self-Hosting
Learn the prerequisites and steps required to self-host the Proxed.AI platform, including setting up necessary services like Supabase, Vercel, and GitHub for your own secure AI API proxy deployment.