openliate 0.0.1 → 0.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +73 -241
- package/README.npm.md +128 -0
- package/dist/bin.js +24644 -42273
- package/dist/liate.js +39479 -0
- package/dist/runtime/hono.js +28072 -0
- package/dist/runtime/index.js +28072 -0
- package/hub/agents/docgyan-agent/agent.json +27 -0
- package/hub/agents/docgyan-agent/agent.ts +39 -0
- package/hub/agents/gnani-agent/agent.json +17 -0
- package/hub/agents/neon-agent/agent.json +18 -0
- package/hub/agents/prism-agent/agent.json +17 -0
- package/hub/agents/sarvam-agent/agent.json +9 -6
- package/package.json +33 -21
- package/src/cli/index.ts +346 -0
- package/src/cli/resolver.ts +153 -0
- package/src/core/aum.ts +87 -28
- package/src/core/om.ts +159 -0
- package/src/core/spec.ts +112 -0
- package/src/core/uuid.ts +5 -16
- package/src/core/version.ts +2 -0
- package/src/layers/agent/harness.ts +118 -0
- package/src/{agent → layers/agent}/loop.ts +44 -24
- package/src/layers/agent/skills.ts +302 -0
- package/src/{agent → layers/agent}/types.ts +14 -1
- package/src/{environment/environment.ts → layers/environment/sandbox.ts} +24 -5
- package/src/{environment → layers/environment}/types.ts +8 -0
- package/src/layers/integration/knowledge.ts +187 -0
- package/src/layers/integration/lib.ts +167 -0
- package/src/{integration → layers/integration}/memory.ts +49 -67
- package/src/layers/integration/repo.ts +273 -0
- package/src/{integration → layers/integration}/types.ts +60 -31
- package/src/layers/llm/model.ts +928 -0
- package/src/layers/llm/types.ts +64 -0
- package/src/{tools → layers/tools}/mcp.ts +24 -10
- package/src/layers/tools/registry.ts +307 -0
- package/src/{tools → layers/tools}/server.ts +12 -13
- package/src/{tools → layers/tools}/types.ts +3 -2
- package/src/liate.ts +64 -24
- package/src/routes/skills.ts +73 -0
- package/src/runtime/hono.ts +346 -0
- package/src/runtime/wasm.ts +23 -0
- package/src/scaffold/project.ts +188 -0
- package/dist/engine/engine.zip +0 -0
- package/dist/engine/index.js +0 -36790
- package/hub/agents/email-agent/agent.json +0 -19
- package/hub/agents/general-agent/agent.json +0 -18
- package/hub/agents/identity-agent/agent.json +0 -19
- package/hub/agents/research-agent/agent.json +0 -18
- package/hub/llm/sarvam.json +0 -27
- package/hub/mcp/agentmail.json +0 -10
- package/hub/mcp/fetch.json +0 -9
- package/hub/mcp/neon.json +0 -12
- package/hub/mcp/sarvam.json +0 -12
- package/hub/mcp/supabase.json +0 -12
- package/hub/mcp/vercel.json +0 -12
- package/src/agent/agent.ts +0 -165
- package/src/cli.ts +0 -272
- package/src/engine/types.ts +0 -104
- package/src/integration/integration.ts +0 -37
- package/src/link/index.ts +0 -317
- package/src/link/neon.ts +0 -646
- package/src/link/supabase.ts +0 -567
- package/src/link/vercel.ts +0 -633
- package/src/llm/config.ts +0 -46
- package/src/llm/hub.ts +0 -59
- package/src/llm/llm.ts +0 -60
- package/src/llm/sarvam.ts +0 -136
- package/src/server/engine.ts +0 -277
- package/src/server/index.ts +0 -32
- package/src/tools/builtin/fetch.ts +0 -66
- package/src/tools/builtin/identity.ts +0 -131
- package/src/tools/registry.ts +0 -218
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 OpenLiate
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 OpenLiate
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,296 +1,128 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
#
|
|
4
|
-
###
|
|
3
|
+
# LIATE — Open Source OOP Framework for AI Agents
|
|
4
|
+
### Where Classes Are AI Agents · From India, For India, Beyond India 🇮🇳 🌍
|
|
5
5
|
|
|
6
6
|
`L[LM] · I[ntegration] · A[gent] · T[ools] · E[nvironment]`
|
|
7
7
|
|
|
8
8
|
<br>
|
|
9
9
|
|
|
10
10
|
<p align="center">
|
|
11
|
-
<a href="https://
|
|
12
|
-
<a href="https://github.com/
|
|
13
|
-
<a href="https://sarvam.ai"><img src="./assets/sarvam-badge.svg" alt="
|
|
14
|
-
<a href="https://codespaces.new/
|
|
15
|
-
<img src="https://img.shields.io/badge/
|
|
11
|
+
<a href="https://openliate.tech/docs"><img src="https://img.shields.io/badge/docs-openliate.tech%2Fdocs-white?labelColor=black&style=flat-square" alt="Docs"></a>
|
|
12
|
+
<a href="https://github.com/OpenLiate/Liate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square" alt="License: MIT"></a>
|
|
13
|
+
<a href="https://sarvam.ai"><img src="./assets/sarvam-badge.svg" alt="Powered by Sarvam AI Startup Program"></a>
|
|
14
|
+
<a href="https://codespaces.new/OpenLiate/Liate"><img src="https://img.shields.io/badge/Codespaces-1--Click_Run-white?logo=github&logoColor=white&labelColor=black&style=flat-square" alt="Open in GitHub Codespaces"></a>
|
|
15
|
+
<a href="https://www.npmjs.com/package/openliate"><img src="https://img.shields.io/badge/npm-v0.1.5-white?labelColor=black&style=flat-square" alt="npm: v0.1.5"></a>
|
|
16
|
+
<img src="https://img.shields.io/badge/Bun-Supported-white?logo=bun&logoColor=white&labelColor=black&style=flat-square" alt="Bun">
|
|
17
|
+
<img src="https://img.shields.io/badge/Node.js-Supported-white?logo=node.js&logoColor=5FA04E&labelColor=black&style=flat-square" alt="Node.js">
|
|
16
18
|
</p>
|
|
17
19
|
|
|
18
20
|
<p align="center">
|
|
19
|
-
<a href="#
|
|
21
|
+
<a href="#aum-architecture"><img src="https://img.shields.io/badge/Agent_Architecture-AUM_(Agent_Unified_Module)-white?labelColor=black&style=flat-square" alt="Agent Unified Module (AUM)"></a>
|
|
20
22
|
|
|
21
|
-
<a href="#
|
|
22
|
-
|
|
23
|
-
<a href="#run-cloud"><img src="https://img.shields.io/badge/Vercel-1M_Runs-white?logo=vercel&logoColor=white&labelColor=black&style=flat-square" alt="Vercel"></a>
|
|
24
|
-
|
|
25
|
-
<a href="#run-cloud"><img src="https://img.shields.io/badge/Supabase-5_Lakhs-white?logo=supabase&logoColor=3ECF8E&labelColor=black&style=flat-square" alt="Supabase"></a>
|
|
26
|
-
</p>
|
|
27
|
-
|
|
28
|
-
<p align="center">
|
|
29
|
-
<a href="#run-cloud"><img src="https://img.shields.io/badge/Worldwide_Edge-16M_Grid-white?labelColor=black&style=flat-square" alt="Worldwide Edge"></a>
|
|
30
|
-
|
|
31
|
-
<a href="#run-cloud"><img src="https://img.shields.io/badge/Fastly-10M_Runs-white?logo=fastly&logoColor=FF282D&labelColor=black&style=flat-square" alt="Fastly"></a>
|
|
32
|
-
|
|
33
|
-
<a href="#run-cloud"><img src="https://img.shields.io/badge/Cloudflare-3M_Runs-white?logo=cloudflare&logoColor=F38020&labelColor=black&style=flat-square" alt="Cloudflare"></a>
|
|
34
|
-
|
|
35
|
-
<a href="#run-cloud"><img src="https://img.shields.io/badge/Azion-3M_Runs-white?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI0Y0NjUyQiIgZD0iTSAyIDE5LjMgTCAxOS44IDIgTCAyMiAyIEwgMTguOCAyMiBMIDE1LjUgMjIgTCAxNy42IDguNyBMIDQuMiAyMiBMIDIuOCAyMiBMIDIgMjEuMSBaIi8+PC9zdmc+&labelColor=black&style=flat-square" alt="Azion"></a>
|
|
36
|
-
</p>
|
|
37
|
-
|
|
38
|
-
<p align="center">
|
|
39
|
-
<a href="#aum-architecture"><img src="https://img.shields.io/badge/Agent_Architecture-AUM_(Agent_Unified_Manifest)-white?labelColor=black&style=flat-square" alt="Agent Unified Manifest (AUM)"></a>
|
|
40
|
-
|
|
41
|
-
<a href="#runtime-engine"><img src="https://img.shields.io/badge/Core_Engine-OM_(Orchestration_Module)-white?labelColor=black&style=flat-square" alt="Core Engine: OM (Orchestration Module)"></a>
|
|
42
|
-
|
|
43
|
-
<a href="#instant-install"><img src="https://img.shields.io/badge/Instant_Install-Zero_Dependencies-white?labelColor=black&style=flat-square" alt="Instant Install"></a>
|
|
44
|
-
|
|
45
|
-
<a href="https://skills.sh"><img src="https://img.shields.io/badge/Agent_Skills-1.5M+_skills.sh_(Vercel_Labs)-white?labelColor=black&logo=vercel&logoColor=white&style=flat-square" alt="1.5M+ Agent Skills (skills.sh)"></a>
|
|
46
|
-
|
|
47
|
-
<a href="https://www.omniroute.online/"><img src="./assets/omniroute-badge.svg" alt="1.62B+ Free AI Tokens Per Month (OmniRoute)"></a>
|
|
23
|
+
<a href="#runtime-engine"><img src="https://img.shields.io/badge/Core_Runtime_Engine-OM_(Orchestration_Module)-white?labelColor=black&style=flat-square" alt="Core Runtime Engine: OM (Orchestration Module)"></a>
|
|
48
24
|
</p>
|
|
49
25
|
|
|
50
26
|
<br>
|
|
51
27
|
|
|
52
|
-
>
|
|
53
|
-
>
|
|
28
|
+
> **Milestone: Liate — Selected for India's Sarvam AI Startup Program 2026** <sup>IN</sup>
|
|
29
|
+
> Built by **[OpenLiate](https://github.com/OpenLiate/Liate)** — Open Source Backend Layer for AI Agents
|
|
54
30
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
>
|
|
58
|
-
> **BaaA — Backend-as-an-Agent.**
|
|
59
|
-
> *Let's Try Liate."*
|
|
31
|
+
> *"If Stripe did payments in 7 lines of code, why not AI Agents in 5 lines of code?*
|
|
32
|
+
> **Class is an Agent. Agent is a Function. Function is an API.**
|
|
33
|
+
> *Don't build AI agents. Integrate by parts."*
|
|
60
34
|
|
|
61
35
|
</div>
|
|
62
36
|
|
|
63
|
-
## <a id="instant-install"></a>[0] Instant Install (Zero Dependencies)
|
|
64
|
-
|
|
65
|
-
```bash
|
|
66
|
-
# 1-Click Run via npx (Zero local install):
|
|
67
|
-
npx openliate run agent.json "Hello World"
|
|
68
|
-
|
|
69
|
-
# Or Install Globally:
|
|
70
|
-
npm install -g openliate
|
|
71
|
-
|
|
72
|
-
# Windows (PowerShell):
|
|
73
|
-
powershell -c "irm https://openliate.tech/install.ps1 | iex"
|
|
74
|
-
|
|
75
|
-
# macOS / Linux (cURL):
|
|
76
|
-
curl -fsSL https://openliate.tech/install.sh | sh
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
> **Prefer 1-Click in Browser?**
|
|
80
|
-
> Run OpenLiate instantly inside [GitHub Codespaces](https://codespaces.new/openliate/openliate) with zero local setup.
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
> **Why 5 Lines? The AI Agent Architecture:**
|
|
84
|
-
> On stage, NVIDIA CEO Jensen Huang proved that an AI Agent is fundamentally 5 elements: **Model (`L`)**, **Knowledge (`I`)**, **Harness (`A`)**, **Tools (`T`)**, and **Sandbox (`E`)**. LIATE maps this directly into 5 lines of declarative execution.
|
|
85
|
-
|
|
86
|
-
```jsonc
|
|
87
|
-
{
|
|
88
|
-
"L": "sarvam/sarvam-105b", // [L] LLM / Model: Text, Reasoning (Sarvam 105B), Decisions, Multimodal
|
|
89
|
-
"I": { "memory": "sessions/hello-agent" }, // [I] Integration / Knowledge: Session Memory, State, Neon Postgres, Frameworks
|
|
90
|
-
"A": { "name": "hello_agent", "intent": "Autonomous Agent", "skills": ["vercel/nextjs"] }, // [A] Agent / Harness: Name, Intent, Vercel skills.sh (1.5M+ skills), ReAct Loop
|
|
91
|
-
"T": ["fetch"], // [T] Tools: MCP v2 (Local Stdio & Remote SSE), Custom APIs
|
|
92
|
-
"E": { "SARVAM_API_KEY": "$SARVAM_API_KEY" } // [E] Environment / Sandbox: Secrets, Cloud Execution, Guardrails
|
|
93
|
-
}
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
```bash
|
|
97
|
-
# Execute your agent (reads L·I·A·T·E directly from agent.json)
|
|
98
|
-
liate run agent.json "Hello Agent World!"
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
> **Prefer writing code directly?**
|
|
102
|
-
> Direct language packages for **npm**, **PyPI**, and other OOP class-based languages (TypeScript, Python, Java, C#, etc.) are coming soon.
|
|
103
|
-
> On Day 1 (`v0.1.0`), Liate is 100% focused on the zero-dependency **Autonomous Runtime Engine (`agent.json`)**.
|
|
104
|
-
|
|
105
|
-
<br>
|
|
106
|
-
|
|
107
37
|
---
|
|
108
38
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
### Millions of AI Agent Runs on Edge Cloud: Function is an Agent.
|
|
112
|
-
#### *Self-Host Anywhere or Bring Your Own Cloud (BYOC) — Free Forever.*
|
|
113
|
-
|
|
114
|
-
<br>
|
|
115
|
-
|
|
116
|
-
## **Class is an Agent. Agent is a Function. Function is an API.** *(Soon)*
|
|
117
|
-
|
|
118
|
-
#### *Liate Agent Protocol Interface (LAPI) is Your Backend.*
|
|
119
|
-
|
|
120
|
-
</div>
|
|
121
|
-
|
|
122
|
-
```typescript
|
|
123
|
-
// Coming Soon: Class is an Agent (TypeScript & Python OOP SDK)
|
|
124
|
-
class HelloAgent {
|
|
125
|
-
L; I; A; T; E; // 1 Class = 5 Properties (L·I·A·T·E) = Same as agent.json
|
|
126
|
-
}
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
## <a id="runtime-engine"></a>[1] Core Engine: OM (Orchestration Module)
|
|
132
|
-
|
|
133
|
-
**Liate's Orchestration Module (OM) is the autonomous runtime engine** — just like Docker executes containers and Ollama executes models, **Liate executes AI agents via OM** across the 5 orthogonal layers (`L · I · A · T · E`).
|
|
134
|
-
|
|
135
|
-
Liate provides three sovereign deployment targets across local hardware, regional cloud, and worldwide edge:
|
|
136
|
-
|
|
137
|
-
---
|
|
138
|
-
|
|
139
|
-
### #1 Run Locally (Native CLI & 1-Click Docker Engine)
|
|
140
|
-
|
|
141
|
-
Run agents anywhere on your own hardware with full Dual-MCP superpowers:
|
|
39
|
+
## Installation
|
|
142
40
|
|
|
143
41
|
```bash
|
|
144
|
-
#
|
|
145
|
-
|
|
42
|
+
# Direct Package:
|
|
43
|
+
npm install openliate
|
|
44
|
+
# or Org-Scoped Package:
|
|
45
|
+
npm install @openliate/liate
|
|
146
46
|
|
|
147
|
-
#
|
|
148
|
-
|
|
47
|
+
# or via Bun:
|
|
48
|
+
bun add openliate
|
|
149
49
|
```
|
|
150
50
|
|
|
151
|
-
* **Full Dual-MCP Support:** Execute both local Stdio MCP tools (`npx`, `uvx`) and remote HTTP/SSE MCP endpoints.
|
|
152
|
-
* **100% Offline & Private:** Zero cloud dependencies, zero external network hops, zero telemetry.
|
|
153
|
-
* **Your Keys:** Reads `$SARVAM_API_KEY` (or OpenAI/Claude) directly from your local `.env`.
|
|
154
|
-
* **Universal Deployment:** Run on your laptop, Mac/Linux/Windows, any VPS (DigitalOcean, Hetzner, AWS), or private Kubernetes cluster.
|
|
155
|
-
|
|
156
51
|
---
|
|
157
52
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
Link your Vercel, Neon, and Supabase accounts with Liate in one click to deploy your autonomous agent engine across all three for `< 1ms` database retrieval:
|
|
161
|
-
|
|
162
|
-
```bash
|
|
163
|
-
# 1-Click Link & Auto-Deploy across all 3 platforms (2.5M Free Runs/mo for $0.00)
|
|
164
|
-
liate link
|
|
165
|
-
|
|
166
|
-
# Or link individual clouds:
|
|
167
|
-
liate link --neon # Provisions project 'liate' & deploys engine (2 vCPU, 8GB RAM + pgvector)
|
|
168
|
-
liate link --vercel # Deploys serverless HTTP engine (1M runs, auto-scales to 0)
|
|
169
|
-
liate link --vercel-daemons # Deploys 24/7 containerized background daemon worker (Node 24 + Python + uvx)
|
|
170
|
-
liate link --supabase # Deploys Edge Function (500k runs + pgvector store)
|
|
171
|
-
|
|
172
|
-
# Relink / refresh tokens and redeploy anytime:
|
|
173
|
-
liate relink # Relink all clouds with fresh OAuth
|
|
174
|
-
liate relink --supabase # Relink specific provider
|
|
175
|
-
|
|
176
|
-
# Unlink & clear saved credentials:
|
|
177
|
-
liate unlink --all # Safely clear all tokens from disk and .env.local
|
|
178
|
-
|
|
179
|
-
# Optional: set private model keys
|
|
180
|
-
liate env set SARVAM_API_KEY="your-key-here"
|
|
181
|
-
```
|
|
53
|
+
## Quickstart: The Frontier Agent (`SovereignAgent`)
|
|
182
54
|
|
|
183
|
-
|
|
184
|
-
* **Vercel Functions & Daemons (1,000,000 / mo):** Fluid Compute functions for Next.js apps, plus 24/7 background agent runners via October 15, 2026 **Vercel Daemons** (`Dockerfile`).
|
|
185
|
-
* **Supabase Edge (500,000 / mo):** Deno V8 edge functions co-located with Postgres auth and realtime database webhooks.
|
|
186
|
-
* **Zero Cross-Region Latency:** Compute lives in the same data center as your database—eliminating network bottlenecks.
|
|
55
|
+
Every agent is declared natively as a TypeScript class inheriting from `liate`. The 5 layers map 1-to-1 to NVIDIA CEO Jensen Huang's 5 foundational agent elements:
|
|
187
56
|
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
57
|
+
```typescript
|
|
58
|
+
import { liate } from "openliate";
|
|
59
|
+
// or if using the org-scoped package:
|
|
60
|
+
// import { liate } from "@openliate/liate";
|
|
61
|
+
|
|
62
|
+
export class SovereignAgent extends liate {
|
|
63
|
+
L = "sarvam/sarvam-105b"; // [L] Large Models Layer (Sarvam Indic 105B)
|
|
64
|
+
I = { memory: "sessions/sovereign-agent" }; // [I] Integration & Memory Layer
|
|
65
|
+
A = { // [A] Agent Harness Layer
|
|
66
|
+
name: "agentyaan",
|
|
67
|
+
intent: "Autonomous Sovereign Indic Agent",
|
|
68
|
+
maxSteps: 5
|
|
69
|
+
};
|
|
70
|
+
T = { // [T] Tools & MCP Layer (Stdio & SSE)
|
|
71
|
+
fetch: {
|
|
72
|
+
command: "uvx",
|
|
73
|
+
args: ["mcp-server-fetch"],
|
|
74
|
+
tools: ["*"]
|
|
75
|
+
}
|
|
76
|
+
};
|
|
77
|
+
E = { SARVAM_API_KEY: "$SARVAM_API_KEY" }; // [E] Environment & Sandbox Layer
|
|
78
|
+
}
|
|
199
79
|
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
80
|
+
// Run the agent via the autonomous ReAct loop:
|
|
81
|
+
const agent = new SovereignAgent();
|
|
82
|
+
const result = await agent.run("Fetch https://openliate.tech and summarize.");
|
|
83
|
+
console.log(result.text);
|
|
204
84
|
```
|
|
205
85
|
|
|
206
|
-
* **Cloudflare Workers (3,000,000 / mo · *Coming Soon*):** Global Google V8 Isolates across 300+ edge cities (100k requests/day free).
|
|
207
|
-
* **Azion Edge Functions (3,000,000 / mo · *Coming Soon*):** Distributed V8 Isolates across 500+ global edge locations with edge storage caching and OAuth MCP integration.
|
|
208
|
-
* **Fastly Compute (10,000,000 / mo · *Coming Soon*):** Pure WebAssembly (WASM) on Wasmtime/Lucet with microsecond cold starts. Orchestrated via Fastly's `@fastly/mcp` streamable-http remote adapter.
|
|
209
|
-
* **Global Low Latency:** Requests terminate at the physical data center closest to the user or webhook sender.
|
|
210
|
-
|
|
211
|
-
---
|
|
212
|
-
|
|
213
|
-
### <a id="run-cloud"></a>Multi-Cloud Capacity Matrix (2.5M Live Runs/mo · 18.5M Total Grid · Zero Vendor Lock-in)
|
|
214
|
-
|
|
215
|
-
OpenLiate organizes multi-cloud agent execution across two clean physical topologies: **Regional Cloud** (co-located with your Postgres memory) and **Worldwide Edge Cloud** (sub-10ms global ingress):
|
|
216
|
-
|
|
217
|
-
| Layer | Physical Topology | Platforms | Free Monthly Runs | Compute Specs & Architecture | Tool Transport `[T]` | Native Memory `[I]` | Cost |
|
|
218
|
-
| :---: | :--- | :--- | :---: | :--- | :--- | :--- | :---: |
|
|
219
|
-
| **Local** | **Self-Host Hardware** | **Local / VPS Docker** *(Live)* | **Unlimited** | Node 24 + Python 3.14 + Astral `uvx` | **Dual MCP**: Stdio + Remote | Local File / In-Memory / SQLite | **$0** |
|
|
220
|
-
| **#1 Cloud** | **Regional Co-Located** | **Neon Functions (BYON)** *(Live)* | **1,000,000** (1M) | Linux Node.js (**2 vCPU, 8 GB RAM**) | Remote MCP (HTTP/SSE) | Serverless Postgres + `pgvector` + Cron | **$0** |
|
|
221
|
-
| **#1 Cloud** | **Regional Co-Located** | **Vercel Functions & Daemons** *(Live)* | **1,000,000** (1M) | Fluid Compute + Docker Daemons | Remote MCP (HTTP/SSE) | Edge Config / KV + `skills.sh` | **$0** |
|
|
222
|
-
| **#1 Cloud** | **Regional Co-Located** | **Supabase Edge (BYOS)** *(Live)* | **500,000** (500k) | Deno V8 Engine | Remote MCP (HTTP/SSE) | Postgres + `pgvector` + Realtime | **$0** |
|
|
223
|
-
| **#2 Edge** | **Worldwide Anycast Edge** | **Cloudflare Workers** *(Soon)* | **3,000,000** (3M) | Global V8 Isolates (300+ cities) | Remote MCP (HTTP/SSE) | Workers KV & D1 Database | **$0** |
|
|
224
|
-
| **#2 Edge** | **Worldwide Anycast Edge** | **Azion Edge Functions** *(Soon)* | **3,000,000** (3M) | Distributed V8 Isolates (500+ PoPs) | Remote MCP (HTTP/SSE) | Edge Storage & KV Caching | **$0** |
|
|
225
|
-
| **#2 Edge** | **Worldwide Anycast Edge** | **Fastly Compute (WASM)** *(Soon)* | **10,000,000** (10M) | WebAssembly (Wasmtime/Lucet) | Remote MCP (HTTP/SSE) | Fastly KV & Secret Store | **$0** |
|
|
226
|
-
| **LIVE TOTAL** | **Regional Multi-Cloud Mesh** | **Neon + Vercel + Supabase** *(Live)* | **2,500,000 / mo** | **Live Serverless Mesh** | **Dual Stdio & Remote MCP** | **Postgres + pgvector** | **$0.00** |
|
|
227
|
-
| **GRID TOTAL** | **Multi-Cloud Sovereign Grid** | **All 6 Sovereign Clouds** | **18,500,000 / mo** | **Decentralized Multi-Cloud Mesh** | **Dual Stdio & Remote MCP** | **Sovereign Multi-Database** | **$0.00** |
|
|
228
|
-
|
|
229
86
|
---
|
|
230
87
|
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
| Capability | Local Self-Host (Docker / CLI) | #1 Regional Cloud (Neon, Vercel, Supabase · *Live*) | #2 Worldwide Edge (Cloudflare, Azion, Fastly · *Coming Soon*) |
|
|
234
|
-
|---|---|---|---|
|
|
235
|
-
| **Environment** | Local machine, VPS, Docker, Kubernetes | AWS Regional Zone (co-located with DB) | 300+ to 500+ Global Anycast Edge PoPs |
|
|
236
|
-
| **Tool Transport [T]** | **Dual-MCP**: Stdio (`npx`/`uvx`) + Remote HTTP/SSE | **Remote MCP** (HTTP/SSE) | **Remote MCP** (HTTP/SSE) |
|
|
237
|
-
| **Native Memory [I]** | In-Memory / File / Local SQLite / Postgres | Serverless Postgres + `pgvector` + Scheduled Cron | Edge KV / Fastly KV / D1 SQLite |
|
|
238
|
-
| **Cost** | **$0** (Free & Open Source forever) | **$0** (Runs on your provider's Free Tier) | **$0** (Runs on your provider's Free Tier) |
|
|
239
|
-
| **Account Ownership** | 100% Sovereign (Your Hardware) | 100% BYOC (Your Own Cloud Account) | 100% BYOC (Your Own Cloud Account) |
|
|
240
|
-
| **Quick Start** | `docker compose up -d` | `liate link` / `liate link --neon` / `liate link --supabase` | `liate link --cloudflare` / `liate link --azion` |
|
|
88
|
+
## Instant Run (Zero Install)
|
|
241
89
|
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
### Invoke from Any App or Webhook via HTTP (LAPI):
|
|
90
|
+
Run any agent directly without installation using `npx`:
|
|
245
91
|
|
|
246
92
|
```bash
|
|
247
|
-
|
|
248
|
-
-H "Content-Type: application/json" \
|
|
249
|
-
-d @agent.json
|
|
93
|
+
npx openliate run agent.ts "Fetch https://openliate.tech and summarize"
|
|
250
94
|
```
|
|
251
95
|
|
|
252
96
|
---
|
|
253
97
|
|
|
254
|
-
##
|
|
98
|
+
## The 5 Layers (L · I · A · T · E)
|
|
255
99
|
|
|
256
|
-
|
|
100
|
+
| Layer | Name | Description |
|
|
101
|
+
| :--- | :--- | :--- |
|
|
102
|
+
| **`L`** | **Large Models** | Universal routing to Sarvam AI (`sarvam-105b`, `sarvam-30b`), Ollama local, or OpenRouter with fallback cascade. |
|
|
103
|
+
| **`I`** | **Integration** | Sovereign memory sessions, vector knowledge graphs, and local execution state. |
|
|
104
|
+
| **`A`** | **Agent Harness** | Autonomous ReAct loop with max-steps safeguards and self-healing error recovery. |
|
|
105
|
+
| **`T`** | **Tools & MCP** | Native Anthropic Model Context Protocol (MCP) clients over stdio and SSE protocols. |
|
|
106
|
+
| **`E`** | **Environment** | Sandboxed environment isolation and secure secret injection. |
|
|
257
107
|
|
|
258
108
|
---
|
|
259
109
|
|
|
260
|
-
##
|
|
261
|
-
|
|
262
|
-
Every agent implements the **Agent Unified Manifest (AUM)** across 5 decoupled pillars declared as class properties or manifest keys:
|
|
110
|
+
## CLI Reference
|
|
263
111
|
|
|
264
|
-
|
|
|
265
|
-
|
|
266
|
-
|
|
|
267
|
-
|
|
|
268
|
-
|
|
|
269
|
-
|
|
|
270
|
-
|
|
|
271
|
-
|
|
272
|
-
> **Unifying the Two Greatest Standards:** Liate natively unifies **Vercel Labs' `skills.sh`** (1.5M+ portable domain skills injected into Layer **[A]**) and **Anthropic's Model Context Protocol (MCP)** (modular tools and actuators in Layer **[T]**). Zero custom glue code required.
|
|
273
|
-
|
|
274
|
-
---
|
|
275
|
-
|
|
276
|
-
## [4] Community & Hub
|
|
277
|
-
|
|
278
|
-
Liate's core runtime is minimal, fast, and focused.
|
|
279
|
-
The **`hub/`** directory belongs to the community:
|
|
280
|
-
|
|
281
|
-
* Add a new LLM -> PR to `hub/llm/`
|
|
282
|
-
* Share your agent -> PR to `hub/agents/`
|
|
112
|
+
| Command | Action |
|
|
113
|
+
| :--- | :--- |
|
|
114
|
+
| `openliate run [file] <prompt>` | Execute agent with a prompt |
|
|
115
|
+
| `openliate chat [file]` | Start interactive multi-turn REPL session |
|
|
116
|
+
| `openliate serve [--port]` | Launch high-performance Hono HTTP/SSE edge runtime |
|
|
117
|
+
| `openliate create <name>` | Scaffold a new agent project |
|
|
118
|
+
| `openliate hub` | List prebuilt agent templates |
|
|
283
119
|
|
|
284
120
|
---
|
|
285
121
|
|
|
286
|
-
## [5] License
|
|
287
|
-
|
|
288
|
-
[MIT](LICENSE) © 2026 OpenLiate. Free and open source forever.
|
|
289
|
-
|
|
290
|
-
<br>
|
|
291
|
-
|
|
292
122
|
<div align="center">
|
|
293
123
|
|
|
294
|
-
|
|
124
|
+
**[Documentation](https://openliate.tech/docs)** · **[Website](https://openliate.tech)** · **[GitHub](https://github.com/OpenLiate/Liate)**
|
|
125
|
+
|
|
126
|
+
Built with ❤️ from India, for India, and beyond India 🇮🇳 🌍
|
|
295
127
|
|
|
296
128
|
</div>
|
package/README.npm.md
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# LIATE — Open Source OOP Framework for AI Agents
|
|
4
|
+
### Where Classes Are AI Agents · From India, For India, Beyond India 🇮🇳 🌍
|
|
5
|
+
|
|
6
|
+
`L[LM] · I[ntegration] · A[gent] · T[ools] · E[nvironment]`
|
|
7
|
+
|
|
8
|
+
<br>
|
|
9
|
+
|
|
10
|
+
<p align="center">
|
|
11
|
+
<a href="https://openliate.tech/docs"><img src="https://img.shields.io/badge/docs-openliate.tech%2Fdocs-white?labelColor=black&style=flat-square" alt="Docs"></a>
|
|
12
|
+
<a href="https://github.com/OpenLiate/Liate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square" alt="License: MIT"></a>
|
|
13
|
+
<a href="https://sarvam.ai"><img src="./assets/sarvam-badge.svg" alt="Powered by Sarvam AI Startup Program"></a>
|
|
14
|
+
<a href="https://codespaces.new/OpenLiate/Liate"><img src="https://img.shields.io/badge/Codespaces-1--Click_Run-white?logo=github&logoColor=white&labelColor=black&style=flat-square" alt="Open in GitHub Codespaces"></a>
|
|
15
|
+
<a href="https://www.npmjs.com/package/openliate"><img src="https://img.shields.io/badge/npm-v0.1.5-white?labelColor=black&style=flat-square" alt="npm: v0.1.5"></a>
|
|
16
|
+
<img src="https://img.shields.io/badge/Bun-Supported-white?logo=bun&logoColor=white&labelColor=black&style=flat-square" alt="Bun">
|
|
17
|
+
<img src="https://img.shields.io/badge/Node.js-Supported-white?logo=node.js&logoColor=5FA04E&labelColor=black&style=flat-square" alt="Node.js">
|
|
18
|
+
</p>
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<a href="#aum-architecture"><img src="https://img.shields.io/badge/Agent_Architecture-AUM_(Agent_Unified_Module)-white?labelColor=black&style=flat-square" alt="Agent Unified Module (AUM)"></a>
|
|
22
|
+
|
|
23
|
+
<a href="#runtime-engine"><img src="https://img.shields.io/badge/Core_Runtime_Engine-OM_(Orchestration_Module)-white?labelColor=black&style=flat-square" alt="Core Runtime Engine: OM (Orchestration Module)"></a>
|
|
24
|
+
</p>
|
|
25
|
+
|
|
26
|
+
<br>
|
|
27
|
+
|
|
28
|
+
> **Milestone: Liate — Selected for India's Sarvam AI Startup Program 2026** <sup>IN</sup>
|
|
29
|
+
> Built by **[OpenLiate](https://github.com/OpenLiate/Liate)** — Open Source Backend Layer for AI Agents
|
|
30
|
+
|
|
31
|
+
> *"If Stripe did payments in 7 lines of code, why not AI Agents in 5 lines of code?*
|
|
32
|
+
> **Class is an Agent. Agent is a Function. Function is an API.**
|
|
33
|
+
> *Don't build AI agents. Integrate by parts."*
|
|
34
|
+
|
|
35
|
+
</div>
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Installation
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
# Direct Package:
|
|
43
|
+
npm install openliate
|
|
44
|
+
# or Org-Scoped Package:
|
|
45
|
+
npm install @openliate/liate
|
|
46
|
+
|
|
47
|
+
# or via Bun:
|
|
48
|
+
bun add openliate
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Quickstart: The Frontier Agent (`SovereignAgent`)
|
|
54
|
+
|
|
55
|
+
Every agent is declared natively as a TypeScript class inheriting from `liate`. The 5 layers map 1-to-1 to NVIDIA CEO Jensen Huang's 5 foundational agent elements:
|
|
56
|
+
|
|
57
|
+
```typescript
|
|
58
|
+
import { liate } from "openliate";
|
|
59
|
+
// or if using the org-scoped package:
|
|
60
|
+
// import { liate } from "@openliate/liate";
|
|
61
|
+
|
|
62
|
+
export class SovereignAgent extends liate {
|
|
63
|
+
L = "sarvam/sarvam-105b"; // [L] Large Models Layer (Sarvam Indic 105B)
|
|
64
|
+
I = { memory: "sessions/sovereign-agent" }; // [I] Integration & Memory Layer
|
|
65
|
+
A = { // [A] Agent Harness Layer
|
|
66
|
+
name: "agentyaan",
|
|
67
|
+
intent: "Autonomous Sovereign Indic Agent",
|
|
68
|
+
maxSteps: 5
|
|
69
|
+
};
|
|
70
|
+
T = { // [T] Tools & MCP Layer (Stdio & SSE)
|
|
71
|
+
fetch: {
|
|
72
|
+
command: "uvx",
|
|
73
|
+
args: ["mcp-server-fetch"],
|
|
74
|
+
tools: ["*"]
|
|
75
|
+
}
|
|
76
|
+
};
|
|
77
|
+
E = { SARVAM_API_KEY: "$SARVAM_API_KEY" }; // [E] Environment & Sandbox Layer
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// Run the agent via the autonomous ReAct loop:
|
|
81
|
+
const agent = new SovereignAgent();
|
|
82
|
+
const result = await agent.run("Fetch https://openliate.tech and summarize.");
|
|
83
|
+
console.log(result.text);
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## Instant Run (Zero Install)
|
|
89
|
+
|
|
90
|
+
Run any agent directly without installation using `npx`:
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
npx openliate run agent.ts "Fetch https://openliate.tech and summarize"
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## The 5 Layers (L · I · A · T · E)
|
|
99
|
+
|
|
100
|
+
| Layer | Name | Description |
|
|
101
|
+
| :--- | :--- | :--- |
|
|
102
|
+
| **`L`** | **Large Models** | Universal routing to Sarvam AI (`sarvam-105b`, `sarvam-30b`), Ollama local, or OpenRouter with fallback cascade. |
|
|
103
|
+
| **`I`** | **Integration** | Sovereign memory sessions, vector knowledge graphs, and local execution state. |
|
|
104
|
+
| **`A`** | **Agent Harness** | Autonomous ReAct loop with max-steps safeguards and self-healing error recovery. |
|
|
105
|
+
| **`T`** | **Tools & MCP** | Native Anthropic Model Context Protocol (MCP) clients over stdio and SSE protocols. |
|
|
106
|
+
| **`E`** | **Environment** | Sandboxed environment isolation and secure secret injection. |
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
## CLI Reference
|
|
111
|
+
|
|
112
|
+
| Command | Action |
|
|
113
|
+
| :--- | :--- |
|
|
114
|
+
| `openliate run [file] <prompt>` | Execute agent with a prompt |
|
|
115
|
+
| `openliate chat [file]` | Start interactive multi-turn REPL session |
|
|
116
|
+
| `openliate serve [--port]` | Launch high-performance Hono HTTP/SSE edge runtime |
|
|
117
|
+
| `openliate create <name>` | Scaffold a new agent project |
|
|
118
|
+
| `openliate hub` | List prebuilt agent templates |
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
<div align="center">
|
|
123
|
+
|
|
124
|
+
**[Documentation](https://openliate.tech/docs)** · **[Website](https://openliate.tech)** · **[GitHub](https://github.com/OpenLiate/Liate)**
|
|
125
|
+
|
|
126
|
+
Built with ❤️ from India, for India, and beyond India 🇮🇳 🌍
|
|
127
|
+
|
|
128
|
+
</div>
|