Skip to content

valon-technologies/gestalt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,963 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gestalt

Stability: Alpha

Gestalt is under active development. APIs and configuration may change between releases. Feedback and bug reports are welcome via GitHub Issues.

Gestalt (/ɡəˈstält/) refers to the idea that the whole is greater than the sum of its parts.

Gestalt is a self-hostable, open source platform for managing agentic tools and services, with declarative configuration and secure credential management built in.

Why Gestalt

Agents need tools. Tools need auth. Auth needs credential storage, encryption, token refresh, and scoped access control. Every team building with agents ends up solving the same infrastructure problems before they can ship.

Gestalt handles this so individual agents and applications do not have to. A single YAML config declares which tools to expose, how users authenticate, and how credentials are managed.

Gestalt architecture diagram

What Gestalt provides

  • Credentials and connection data are encrypted at rest, on infrastructure you control.
  • A single YAML config declaratively defines which tools to expose, how users authenticate, and how credentials are managed.
  • The same operations are available over MCP, HTTP, CLI, and optional mounted web UIs for cloud agents, local coding assistants, and human operators.
  • Auth backends, IndexedDB storage, secrets managers, caches, telemetry, audit sinks, and public web UIs are all provider packages.
  • Deploy on infrastructure you control with Docker, Helm, or your own container platform.

What Gestalt Is Not

Gestalt is not a SaaS platform. It is open source and self-hostable on infrastructure you control, so you keep ownership of your data, credentials, and deployment.

Gestalt also does not replace your existing APIs. It sits between agents and upstream services, handling auth and credential lifecycle while your APIs stay where they are.

Quick Start

Tap the Gestalt Homebrew repository and install both binaries:

brew tap valon-technologies/gestalt
brew install valon-technologies/gestalt/gestaltd
brew install valon-technologies/gestalt/gestalt

Start the server:

gestaltd

When no config file exists, gestaltd generates ~/.gestaltd/config.yaml, starts with SQLite storage via the first-party RelationalDB provider, mounts the default UI at /, enables a default HTTPBin plugin, and listens on http://localhost:8080.

In a second terminal, connect the CLI to the server:

gestalt init
gestalt plugin list
gestalt plugin invoke httpbin get_ip

For the full walkthrough, see Getting Started.

Repository Layout

Path Description
gestaltd Go server daemon, config loading, provider bootstrap, HTTP API, MCP surface, deployment assets, and admin UI serving code.
gestalt Rust CLI client for setup, auth, plugin invocation, workflow and agent runs, and token management.
sdk Go, Python, Rust, and TypeScript SDKs plus shared protocol definitions.
docs Source for the public documentation site at gestaltd.ai.

About

Self-hostable platform for managing agentic tools and services, with declarative configuration and secure credential management built in.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors