Installation

Installation

Local Cluster Setup

Podex works with any local Kubernetes cluster. Here's how to set one up:

Using Kind (Kubernetes-in-Docker):

kind create cluster --name podex
kubectl cluster-info

Using Minikube:

minikube start
kubectl cluster-info

Prerequisites

• Docker and Docker Compose Install Docker
• Kind or Minikube Install Kind / Install Minikube
• A populated config file at ~/.kube/config

Running Podex

git clone https://github.com/Hritikraj8804/podex.git
cd podex
docker compose up --build

This builds:

1. Backend container (port 8000) Python FastAPI server
2. Frontend container (port 5173) Nginx serving React app + proxying API

Access the UI at http://localhost:3000.

Environment Variables

Backend:

• GEMINI_API_KEY or GOOGLE_API_KEY API key for Google Gemini
• OPENAI_API_KEY API key for OpenAI
• OPENAI_BASE_URL Custom endpoint for self-hosted LLM servers
• OPENAI_MODEL Model name (e.g. gpt-4o-mini)
• DOCKER_MODE Set to true in Docker to enable address patching

Frontend:

• VITE_API_URL API daemon address (default: http://localhost:8000)