AgentBlock/README.md

Run and deploy your AI Studio app

This contains everything you need to run your app locally.

View your app in AI Studio: https://ai.studio/apps/b6ca5081-8525-4b56-8fbc-92c242c9ae8a

Run Locally

Prerequisites: Node.js

1. Install dependencies: npm install
2. Set the GEMINI_API_KEY in .env.local to your Gemini API key
3. Run the app: npm run dev

Run With Docker

Production deployment (minimum Docker download):

1. Create .env.local from .env.example and set GEMINI_API_KEY.
2. Build the static files locally with the dependencies already installed: npm run build
3. Start the production container: docker compose up --build -d
4. Open http://localhost:8080.

The production compose stack runs two services:

• app: nginx serves the host-built dist folder on http://localhost:8080
• api: the VISA API runs on http://localhost:4000

nginx also proxies API calls under http://localhost:8080/api/... to the API container. The frontend image copies the local dist directory into nginx:stable-alpine3.23-slim; it does not download Node or reinstall npm packages inside the frontend Docker image.

Development server (optional, downloads a Node image and dependencies):

1. Create .env.local from .env.example and set GEMINI_API_KEY.
2. Start the development container: docker compose -f docker-compose.dev.yml up --build
3. Open http://localhost:3000.

The development compose stack runs Vite on http://localhost:3000 and the VISA API on http://localhost:4000.