# What Gipity Can Do

The agent-tuned platform where AI-built apps live.

One platform — not seven SaaS products stitched together. Gipity is agent-tuned from scaffold to deploy: hosting, databases, file storage, deployment, scheduled workflows, and monitoring are all first-class. Your AI-built apps don't just ship — they run on a platform built to keep them running.

No lock-in at any layer — any coding agent, any model, fully exportable to run on AWS, Azure, or your own hardware. Always your code.

Use Gipity directly in your browser, or pair with Claude Code in your terminal and your local agent gets cloud superpowers. No setup, no API keys, no config files.

## Build Apps & Websites
Tell the agent what you want and it builds it - HTML, CSS, JavaScript, deployed to a live URL. No IDE, no terminal, no Git.

- "Build me a portfolio site" - scaffolded, styled, deployed in minutes
- "Make a todo app with a database" - full-stack with persistent storage
- "Create a multiplayer trivia game" - real-time WebSocket rooms, shared state
- "Build a dashboard that shows my sales data" - charts, tables, auto-refresh

Apps deploy to `dev.gipity.ai` (testing) or `app.gipity.ai` (production). Auto-deploy mode pushes changes live on every file edit.
*Load `web-app-basics` for best practices, `app-development` for backend APIs.*

## 3D World

**3D World** is the 3D multiplayer game template on Gipity. All 3D World games share the same visual style, physics engine (Rapier), and multiplayer backend (Colyseus). All files are fully editable.

Scaffold a 3D World project with `app_scaffold type=3d-world` (web agent) or `gipity scaffold --type 3d-world` (CLI). This creates a playable 3D game with Three.js + Rapier physics + Colyseus multiplayer. Key files: `config.js` (metadata), `settings.js` (tunable values), `strings.js` (display text), `objects.js` (entity factories), `game.js` (orchestrator), plus engine files (`core.js`, `world.js`, `physics.js`, etc.).

**Genres:** obby/parkour, tycoon, simulator, PvP combat, shooter, tower defense, horror, racing, RPG, social.

**Features:** Opt-in gameplay modules enabled via `config.features`. Available: `rocket-launcher` (projectile weapon with physics explosions). Example: `features: { 'rocket-launcher': true }` in config.js. Features auto-initialize during boot.

Regular game requests ("make a wordle", "build a quiz") should use the standard web scaffold — they don't need the 3D template.

*Load `3d-engine` for a blank-slate 3D template, or `3d-world` for the full API, genre recipes, and playable starter.*

## Backend Services - No API Keys Needed
Your deployed apps can call AI models, generate images, create speech, and play sound effects - all through built-in API services. No third-party accounts or API keys required.

- **LLM**: GPT-5, Claude, Gemini - streaming or non-streaming
- **Image generation**: OpenAI (gpt-image-1, DALL-E 3), BFL/Flux, Gemini/Nano Banana
- **Video generation**: Google Veo 3.1 - AI-generated short videos with audio
- **Text-to-speech**: ElevenLabs, OpenAI, Gemini (30 voices, multi-speaker, 60+ languages)
- **Audio**: Sound effects, music generation, transcription
- **Video understanding**: Analyze video content with Gemini multimodal AI

Two billing modes: you pay (simple) or your app users pay from their own credits.
*Load `app-llm`, `app-image`, `app-video`, `app-tts`, `app-audio`, or `app-files` for integration details.*

## Databases
Per-project PostgreSQL schemas. Full SQL - create tables, query data, build APIs on top. The agent handles the SQL for you.

- "Track my expenses in a database" - schema designed, tables created, data entry via chat
- "Build an API for my app's leaderboard" - serverless functions callable from deployed apps

Up to 10 databases per user.
*Load `app-development` for functions, database setup, and API patterns.*

## Code Execution
Sandboxed Docker containers with JavaScript (Node 20), Python 3, Bash, and 60+ pre-installed CLI tools. Data analysis, file conversion, image processing, document generation - all without leaving chat.

- "Analyze this CSV and make a chart" - pandas + matplotlib, chart saved to files
- "Convert this PDF to Word" - LibreOffice headless
- "Resize all these images to 800px wide" - ImageMagick one-liner
- "Cross-compile this C program for Windows" - mingw-w64

*Load `sandbox-tools` for the full tool and library list.*

## Automate Anything
Multi-step workflows triggered by schedule, webhook, or manual run. Each step is an AI call with full tool access.

- "Send me a daily weather briefing at 7am" - cron-scheduled workflow
- "Monitor this website and alert me if the price drops" - scheduled check + email
- "Every Monday, summarize my calendar and email me" - Gmail + Calendar + email

Human-in-the-loop approval steps for anything that needs sign-off before proceeding.
*Load `workflow-guide` for cron syntax and patterns, `approvals-guide` for approval flows.*

## Generate Media
Images, speech, sound effects, and music - generated on demand and saved to your files.

- "Generate a logo for my app" - OpenAI or Flux image generation
- "Read this article aloud" - ElevenLabs or OpenAI TTS
- "Make a thunder sound effect" - ElevenLabs sound generation
- "Create 30 seconds of lo-fi background music" - ElevenLabs music generation

*Load `tts-guide` for voice and audio details.*

## Search the Web & Social Media
Real-time web search (Brave) and Twitter/X search (last 7 days). The agent can research current events, find documentation, check prices, and monitor social media.
*Load `web-search` for operators and tips.*

## Connect External Services
Gmail, Google Calendar, Slack, GitHub, Todoist, Notion, Telegram - connect accounts and the agent can read, send, and manage on your behalf.
*Load `google-services`, `service-call`, or `telegram-connector` for setup.*

## Persistent Memory
The agent remembers what matters across conversations. Two scopes:
- **Agent memory** - personal, available in all projects (preferences, facts, context)
- **Project memory** - shared across agents in a project (specs, decisions, architecture)

You can ask the agent to remember or forget anything. Memory is also auto-extracted from conversations.

## File Management & Recovery
Per-project file workspaces with full CRUD. Files generated by tools (images, audio, video, sandbox outputs) are saved as project files automatically. Every file write is tracked with immutable version history - you can view versions, restore individual files, or roll back entire directories to any point in time.
*Load `version-history-guide` for recovery options.*

## Multi-Model AI
Claude (Sonnet, Opus, Haiku) and GPT (GPT-4.1, GPT-5) families. Switch models per agent. Extended thinking mode for complex reasoning. Cross-model queries to get second opinions.
*Load `query-llm-guide` for cross-model queries.*

## User Authentication for Apps
Apps on Gipity can authenticate Gipity users with zero setup - session cookies, no OAuth configuration needed.
*Load `app-auth` for implementation details.*

## Real-Time Multiplayer
WebSocket rooms for games and collaborative apps. Relay (message broker) or state (server-authoritative) modes. Up to 200 clients per room.
*Load `app-realtime` for room types and client code.*

## Local Claude Code via `gipity relay`
Run Claude Code on your own PC and drive it from the Gipity web CLI on any browser (desktop or phone). After installing the `gipity` CLI locally, run `gipity relay pair` to link the device, `gipity relay enable` inside a project dir, and `gipity relay run` (or `gipity relay install` to auto-start at login). Then in the web CLI type `/claude` (or `/cc`) - your prompt switches to `cc>` and each message dispatches to your PC, spawns `gipity claude -p "<msg>"`, and streams the conversation back into the terminal view. Every prompt, tool call, and assistant turn is captured for later viewing. `exit` returns to the normal Gipity prompt.

## Platform Limits
- **Storage**: 1 GB per user
- **Databases**: up to 10 per user
- **Concurrent chats**: 3 per user
- **Deploy rate**: 10 deploys per minute

## Where to Start
Just ask. "Build me a website." "Analyze this data." "Set up a daily email." "What can you help me with?" The agent will figure out the tools, the code, and the deployment. You describe what you want - the AI handles the how.
