Vertice Code User Manual
Vertice Code is a Collective AI Platform designed for high-performance engineering teams. It unifies Human Intent, AI Execution, and Institutional Memory into a single "Trinity" system.
Chat System (SaaS)
The core interface for interacting with Vertice. It is not just a chatbot, but a stateful engineering partner. Acessible via /chat.
Features
- Streaming ProtocolReal-time token generation with Vercel AI SDK Data Stream Protocol. Zero latency perception.
- ACID PersistenceAll conversations are stored in PostgreSQL with strict transaction integrity. History never vanishes.
Model Selection
The system intelligent routes your request based on complexity:
- Gemini 1.5 Pro: For complex reasoning and architecture (Pro Tier).
- Gemini 1.5 Flash: For high-speed tasks and simple queries (Free Tier).
TUI & CLI
The "Power User" interface. Designed for 10x Engineers who live in the terminal.
# Install locally
$ pip install vertice-code
# Launch TUI (Textual UI)
$ vertice
# Run Headless command
$ vertice -p "Refactor src/main.py"
Note: The TUI renders at 60fps and supports mouse interaction. It connects to the same backend as the Web App, sharing memory and context.
Prometheus Meta-Agent
Level 4 Autonomy. Prometheus is the "Self-Evolution" engine of Vertice. It runs in the background (CI/CD loop) to improve the codebase without human intervention.
- Self-Correction: Detects bugs and proposes fixes (Tribunal System).
- Evolution: Optimizes its own prompts and tools over time.
- Verification: Runs `verify_prometheus.py` before every release to ensure sanity.
Billing & Plans
Vertice offers transparent pricing integrated with Stripe.
Free Tier
$0/mo
- ✓ Gemini 1.5 Flash
- ✓ Basic Chat History
- ✓ Community Support
Pro Tier
$29/mo
- ✓ Gemini 1.5 Pro (Enterprise)
- ✓ Unlimited History
- ✓ TUI & CLI Access
- ✓ Priority Processing
Security & Auth
Security is not an addon; it is the foundation. We employ a Zero-Trust Architecture.
- Authentication: Google OAuth 2.0 via Firebase Admin.
- Token Revocation: Logging out instantly invalidates access tokens globally. No "zombie sessions".
- Rate Limiting: DDoS protection active on all API endpoints.
- Auditing: All sensitive actions are logged in an immutable audit trail.
Multi-Tenancy
Your data is yours. Vertice uses Strict Logical Isolation to ensure no data leakage between tenants.
Every resource (chat, document, setting) is tagged with a unique `tenant_id`. The backend middleware enforces this isolation at the database query level. We permit NO CROSS-TENANT ACCESS, verified by our `verify_multitenancy.py` E2E test.