<a href="https://futureagi.com?utm_source=github&utm_medium=readme&utm_campaign=oss_repo&utm_content=logo"> <img alt="Future AGI — make AI agents reliable" src="frontend/public/assets/readme/Logo.png" width="100%"> </a>
Core features
Six pillars. Each one replaces a tool you probably have.
Deployment options
Target
Status
Notes
Docker Compose: Standalone
✅
./bin/install: one app container next to Postgres and ClickHouse, for a laptop or a single VM
Docker Compose: Distributed
✅
./bin/install --distributed: one container per service, for scale on one host
Production Compose overlay
✅
./deploy/setup.sh on the Distributed setup: --skip-up writes deploy/.env.production (generating only the secrets you do not supply; you give every image version), then, once the databases are initialized, --confirm-initialized pulls the images and starts the stack ([deploy/README.md](deploy/README.md))
Kubernetes / Helm
✅
Distributed on Kubernetes: helm install futureagi oci://ghcr.io/future-agi/charts/futureagi --version X.Y.Z, one signed chart for the open-source and Enterprise editions ([chart README](deploy/helm/futureagi/README.md))
AWS / GCP / Azure
✅
Docker Compose on a VM, or the Helm chart on a Kubernetes 1.27+ cluster
AWS Marketplace
⏳
Coming soon
Air-gapped / on-prem
✅
Mirror the images, set FUTURE_AGI_TELEMETRY_DISABLED=true and block outbound traffic ([Telemetry](#telemetry)); on Helm, set global.airgap=true and mirror the images the release lists ([chart README](deploy/helm/futureagi/README.md#enterprise)); [contact sales](mailto:sales@futureagi.com) for support
You need Docker Desktop or Docker Engine with Compose v2.24 or newer, and for the default Standalone setup 2 vCPUs and 4 GB of memory given to Docker.
Future AGI Cloud
Self Host Future AGI
No installation required, get started immediately.
Generous free-tier, no credit card required.
<sub>SOC 2 Type II · HIPAA · data stays in your region.</sub>
</td> <td width="50%">
One command, full stack. Published images, no source build.
git clone https://github.com/future-agi/future-agi.git
cd future-agi
./bin/install # Windows (PowerShell): .\bin\install.ps1
</td> </tr> </table>
The installer checks your machine, writes this install's secrets to .env, downloads the images (about 800 MB) and waits until everything answers. The first boot sets up the database and takes a few minutes; <http://localhost:3000> shows its progress meanwhile.
2. Sign in and copy your keys
Open <http://localhost:3000>, create your account (or sign in with the one the installer made), then copy the API key and secret key from Keys in the sidebar.
from fi_instrumentation import register
from fi_instrumentation.fi_types import ProjectType
tracer_provider = register(project_name="my-first-project", project_type=ProjectType.OBSERVE)
with tracer_provider.get_tracer("quickstart").start_as_current_span("hello-future-agi") as span:
span.set_attribute("input.value", "Hello, Future AGI")
tracer_provider.force_flush()
Open Tracing in the sidebar: my-first-project holds your first span. http://localhost:4318 is this install's trace collector; it listens on this machine only.
**Standalone** (default)
**Distributed** (at scale)
Install
./bin/install
./bin/install --distributed
Runs
one app container, Postgres, ClickHouse
one container per service, PeerDB, Kafka
Docker resources
2 vCPUs, 4 GB
4+ vCPUs, 12–16 GB
Kubernetes
[Helm chart](deploy/helm/futureagi): about 4 CPUs and 8 GiB free for an evaluation
Choose before you add data: there is no supported way to move a Standalone install's data to Distributed or Helm later (Switching).
- Configure: every variable in .env is described in the configuration reference. Nothing is required for a local install; add LLM provider keys, a public URL or email when you need them. - Manage:docker compose logs -f app (Distributed: backend); stop with docker compose down or ./bin/uninstall (both keep your data); upgrade with git pull && ./bin/install; remove everything, data included, with ./bin/uninstall --purge. - Develop: on a branch other than main, add --from-source to build the images from your checkout; ./bin/dev runs it with hot reload (Local development). - More: the self-hosting guide, INSTALLATION.md (every option and troubleshooting) and deploy/README.md (production).
SDKs & integrations
Future AGI is an open-source ecosystem — each SDK is independently usable, independently packaged, Apache/MIT-licensed.
