Technical Architecture

The Full-Stack Agent Factory

Most agent builders only solve the backend—the LLM logic. Sicaya lets you deploy complete, production-ready applications with frontend UI, real-time streaming, and backend agent logic. Every Marketplace app comes with its own interface, ready to run.

Complete application architecture, generated.

Frontend React / Next.js + AG UI Components
Protocol AG UI (Agent-User Interaction Protocol)
Backend Google ADK (Python) + FastAPI
Infra Any Cloud / On-Premise / Your VPC

Why this matters

Traditional agent builders give you a chat widget or API endpoint. Sicaya delivers complete applications—frontend UI, backend logic, and infrastructure config—that you deploy and own.

  • Every Marketplace app includes its own production-ready UI
  • Real-time streaming shows users what the agent is doing
  • Clean code you can inspect, modify, and extend
  • Deploy anywhere—any cloud, on-premise, or edge

Four architectural advantages

The technical decisions that make Sicaya agents production-ready from day one.

01

Generative UI via AG UI Protocol

Standard agents return text. Sicaya agents return components. When the backend decides the user needs a loan calculator, it sends a signal via AG UI, and the frontend instantly renders an interactive widget.

How it works

  • Agent determines UI need based on conversation context
  • Sends structured component request via AG UI protocol
  • Frontend renders pre-built or custom React components
  • User interacts; state flows back to agent seamlessly
02

Code-First Output (Google ADK)

Sicaya generates clean, standard Python code using Google's Agent Development Kit—not proprietary configurations that lock you into a vendor's runtime.

Developer benefits

  • Version control with Git like any codebase
  • Unit test and debug with standard Python tools
  • Extend with custom tools, integrations, and logic
  • Deploy anywhere Python runs—any cloud or on-premise
03

Real-Time Streaming & State

The hardest part of building agents is managing the connection between browser and server. AG UI standardizes how thinking states, tool inputs, and intermediate steps stream to users.

What users experience

  • "Scanning database..." → "Found 3 records" → "Rendering table"
  • Tool calls visible as they happen
  • Thinking states that build trust through transparency
  • WebSocket/SSE connections handled automatically
04

Model Agnostic

Sicaya agents are built on open standards. Swap models, change providers, or run locally—your agent code stays the same.

Built-in capabilities

  • Support for any LLM provider (OpenAI, Anthropic, Google, etc.)
  • Configurable safety guardrails
  • Built-in hooks for tracing and logging
  • Run on any Kubernetes cluster

What Weaver produces

Clean, readable Python code you can inspect, extend, and deploy. No black boxes.

loan_agent.py
1 from google.adk import Agent, Tool
2 from ag_ui import UIComponent
3
4 @Agent(model="gemini-1.5-pro")
5 class LoanAdvisorAgent:
6 """Helps users evaluate loan options."""
7
8 @Tool
9 def show_calculator(self, principal, rate):
10 # Renders interactive UI component
11 return UIComponent(
12 type="LoanCalculator",
13 props={"principal": principal}
14 )

What you get

This isn't pseudo-code. It's the actual structure Weaver generates—clean Python that any developer can understand, modify, and extend.

  • Line 1-2: Standard imports from Google ADK and AG UI
  • Line 4: Declarative model selection with simple decorator
  • Line 8-14: Tool that returns an interactive UI component, not just text
  • Extensible: Add your own tools, connect to your APIs, customize the logic

Why CTOs choose code-first

No Vendor Lock-in

Standard Python code runs anywhere. Move between cloud providers or go on-premise without rewriting.

Full Auditability

Every line of code is visible. Security teams can review, compliance can audit, developers can debug.

Developer Trust

Engineering teams prefer code they can version control, test, and extend over black-box configurations.

Future-Proof

Swap models, add integrations, extend capabilities. Your investment grows with the ecosystem.

See the architecture in action.

30-minute technical review. We'll show you how Weaver generates production-ready code and walk through a deployment scenario tailored to your infrastructure.

Book Technical Review