Skip to content

Prepare a project

A SmartAGT project starts with the choice of a topology, according to the expected availability and load. Choose it at the top of the page: the architecture and the path adapt to it. For a first discovery, the PoC provides a fixed scenario on one VM.

Architecture

Without a high-availability requirement, for a light to medium load, with regular backups of the server and the databases.

Single serverOne VM hosts every component, each linked to its clients
SmartAGT VM
Backend
BrowserUser workstations
Applications
AI clients
FrontendInterface and sessions
APIAgents and business logic
GatewayModel access
WorkersIngestion, indexing and deferred tasks
PostgreSQLData, sessions and vectors
SeaweedFSFiles
ModelsPrivate or SaaS
FrontendHTTPS :9000 Public APIHTTPS :8000 GatewayHTTPS :8001 Internal linkmTLS :8010 TLS :5432 TLS :5432 mTLS :8888 HTTPS

Default accessApplication and AI accessInternal and outbound flows

For high availability and a high, steady load.

ClusterOne block per node, shared PostgreSQL and S3
Backend
BrowserUser workstations
Applications
AI clients
Load balancerWeb entry point
Frontend VMsInterface and sessions
Load balancerTCP passthrough (L4)
Platform VMsPublic API, internal link and Gateway
Worker VMsIngestion and indexing
PostgreSQLShared service
S3Shared private bucket
ModelsPrivate or SaaS
HTTPS :443 FrontendHTTPS :9000 Public APIHTTPS :8000 GatewayHTTPS :8001 Internal linkmTLS :8010 TLS :5432 TLS :5432 HTTPS HTTPS

Default accessApplication and AI accessNode-to-node and outbound flows

For high density, a variable load and several organizations.

KubernetesPostgreSQL and S3 remain services outside the containers
Application containers
Backend
BrowserUser workstations
Applications
AI clients
Ingress or proxyWeb entry point
FrontendInternal service
PlatformPublic API, internal link and Gateway
WorkersIngestion and indexing
PostgreSQLExternal service
S3External private bucket
ModelsHTTPS services
HTTPS :443 FrontendHTTPS :9000 Public APIHTTPS :8000 GatewayHTTPS :8001 Internal linkmTLS :8010 TLS :5432 TLS :5432 HTTPS HTTPS

Default accessApplication and AI accessService-to-service and outbound flows

Prepare the environment

Complete these prerequisites before installing SmartAGT.

Step Operation Result
1 Prepare PostgreSQL Compliant instance, pgvector installed.
2 Prepare the databases Databases, roles and extensions ready.
Step Operation Result
1 Prepare PostgreSQL Instance reachable through its virtual address.
2 Prepare the databases Databases, roles and extensions ready.
3 Configure S3 Shared private bucket reachable.

Under construction

The preparation procedures for Kubernetes are coming soon. The architecture above describes the target.

Install SmartAGT

Run every operation on the server.

Step Operation Result
1 Install the Backend Platform, workers and AI Gateway running.
2 Install the Frontend HTTPS sign-in reachable.
3 Activate the installation Password changed, license active.
4 Getting started Models connected, sourced answer.
5 Secure the installation Checklist applied.

Run every operation on the nodes that carry the relevant role.

Step Operation Result
1 Install the Backend Services running by role, a single initialization.
2 Install the Frontend HTTPS sign-in on every Frontend node.
3 Configure a reverse proxy Single public name in front of the Frontends.
4 Activate the installation Password changed, license active.
5 Getting started Models connected, sourced answer.
6 Secure the installation Checklist applied.

Under construction

The installation procedures for Kubernetes are coming soon.

Update the project

To update the project, follow the Update procedure.