System requirements
PoC profile
| Item | Reference profile |
|---|---|
| Machine | One x64 VM, 4 vCPU, 16 GB RAM |
| Disk | 100 GB SSD |
| System | Linux x86_64 (Ubuntu 22.04 LTS, Debian 12 or later) or Windows Server 2022 x64 or later: minimums |
| Database | PostgreSQL 18, pgvector built for PG18, unaccent extension |
| Files | Managed SeaweedFS, binary included in the Backend package |
| Models | Remote conversation, embedding, OCR and image services |
| User access | VM DNS name, HTTPS to the Frontend service on TCP 9000 |
| Administration | sudo on Linux or an elevated Windows console for installation |
This profile defines the documented scenario; it does not guarantee a simultaneous user count. No GPU is required on the VM because inference is remote. The PoC journey gives the installation sequence.
Operating systems
| System | Minimum required | Validated |
|---|---|---|
| Linux | x86_64, glibc 2.35 or later, systemd: Ubuntu 22.04 LTS, Debian 12 or later | Ubuntu 24.04 LTS |
| Windows | Windows Server 2022 x64 or later, 64-bit PowerShell 5.1 | Windows Server 2022 |
Linux binaries are built against glibc 2.35: RHEL 9 and its derivatives (glibc 2.34) are not supported.
Host dependencies
| Linux | Windows |
|---|---|
| systemd | Windows services and Windows Firewall; NSSM as an alternative mode |
curl, for the procedure checks |
Visual Studio C++ tools, to build pgvector on the server or on a preparation workstation |
| Prepare PostgreSQL | Prepare PostgreSQL |
SmartAGT executables bundle their runtime: no Python needs to be installed on the server.
Network and certificates
Private network
SmartAGT is designed for a private network, without direct Internet exposure: Network exposure.
Prepare TLS identities for the Frontend service and public API, along with trust for connected external services. Encrypting PostgreSQL is recommended in production: PostgreSQL SSL. Align DNS, system time, certificate SANs and trusted authorities. The user workstation also trusts the Frontend service CA. The link between the Frontend service and the API, and managed storage, use certificates issued by SmartAGT: no certificate is required for them.
The upstream firewall allows the workstation network to reach TCP 9000 on the VM. Data ports remain restricted to components. On the API server, TCP ports 8010 and 8011 stay available for the Internal listener and the local enrollment endpoint, both on loopback on a single VM. A reverse proxy can present the Frontend service on 443 in the project journey.
Ports and flows lists sources and destinations. The Install your certificates procedure provides evaluation certificates or settings for your PKI.
Project sizing
| Requirement | Resource to assess |
|---|---|
| Conversation load | Application CPU/RAM, provider concurrency, PostgreSQL connections and pools for concurrent conversations and long calls |
| Document ingestion | Volume throughput and capacity, vector indexes, RAG workers and embedding API for the corpus and concurrent ingestion |
| Local processing | Runtime CPU/GPU and memory, model cache and dependencies for OCR, local models or large pages |
| Generated files | Image and object size, retention and storage access |
| High availability | Role placement, shared data, PostgreSQL and storage availability |
| AI Gateway | Additional processes and pools, external client throughput |
The catalog's local OCR pipelines run on CPU. Their weights, decoded pages and concurrent calls require additional memory headroom and disk cache. Access to the weights repository is used for explicit preparation; extraction then reads the local cache, which must be accessible to the service account. Tesseract and its language data are not required.
These requirements are not implicitly included in the PoC's 16 GB. Project architectures explains their effect on component placement.