liate 0.0.0__tar.gz
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.
- liate-0.0.0/.github/ISSUE_TEMPLATE/bug_report.yml +45 -0
- liate-0.0.0/.github/ISSUE_TEMPLATE/config.yml +8 -0
- liate-0.0.0/.github/ISSUE_TEMPLATE/feature_request.yml +39 -0
- liate-0.0.0/.gitignore +40 -0
- liate-0.0.0/CHANGELOG.md +34 -0
- liate-0.0.0/LICENSE +21 -0
- liate-0.0.0/PKG-INFO +238 -0
- liate-0.0.0/README.md +221 -0
- liate-0.0.0/pyproject.toml +25 -0
- liate-0.0.0/src/liate/__init__.py +29 -0
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
name: "Bug Report"
|
|
2
|
+
description: "Report a bug or unexpected behavior in the LIATE runtime"
|
|
3
|
+
title: "[Bug]: "
|
|
4
|
+
labels: ["bug"]
|
|
5
|
+
body:
|
|
6
|
+
- type: markdown
|
|
7
|
+
attributes:
|
|
8
|
+
value: |
|
|
9
|
+
Thanks for taking the time to report an issue! Please provide clear details to help reproduce it.
|
|
10
|
+
- type: textarea
|
|
11
|
+
id: description
|
|
12
|
+
attributes:
|
|
13
|
+
label: "Describe the Bug"
|
|
14
|
+
description: "A clear and concise description of what the bug is."
|
|
15
|
+
placeholder: "When running HelloAgent on Node v22, the MCP stdio connection hangs..."
|
|
16
|
+
validations:
|
|
17
|
+
required: true
|
|
18
|
+
- type: textarea
|
|
19
|
+
id: repro
|
|
20
|
+
attributes:
|
|
21
|
+
label: "Minimal Reproduction Code (5 Lines)"
|
|
22
|
+
description: "Provide the minimal LiateAgent class that triggers the issue."
|
|
23
|
+
render: typescript
|
|
24
|
+
placeholder: |
|
|
25
|
+
class BugAgent extends LiateAgent {
|
|
26
|
+
constructor() {
|
|
27
|
+
super({
|
|
28
|
+
L: "sarvam/sarvam-105b",
|
|
29
|
+
I: {},
|
|
30
|
+
A: { name: "test", prompt: "..." },
|
|
31
|
+
T: ["mcp/local"],
|
|
32
|
+
E: { SARVAM_API_KEY: "..." }
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
validations:
|
|
37
|
+
required: true
|
|
38
|
+
- type: input
|
|
39
|
+
id: environment
|
|
40
|
+
attributes:
|
|
41
|
+
label: "Runtime Environment"
|
|
42
|
+
description: "OS, Node/Bun/Deno version, and Liate version."
|
|
43
|
+
placeholder: "Windows 11 / Bun v1.2 / Liate v0.1.0"
|
|
44
|
+
validations:
|
|
45
|
+
required: true
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
blank_issues_enabled: false
|
|
2
|
+
contact_links:
|
|
3
|
+
- name: "LIATE Documentation"
|
|
4
|
+
url: "https://liate.dev"
|
|
5
|
+
about: "Read the official LIATE documentation and 5-layer guide."
|
|
6
|
+
- name: "Community Discussions"
|
|
7
|
+
url: "https://github.com/solovinod/liate/discussions"
|
|
8
|
+
about: "Ask questions, share your 5-line agents, or discuss ideas."
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
name: "Feature Request"
|
|
2
|
+
description: "Suggest an idea or enhancement for the LIATE runtime"
|
|
3
|
+
title: "[Feature]: "
|
|
4
|
+
labels: ["enhancement"]
|
|
5
|
+
body:
|
|
6
|
+
- type: markdown
|
|
7
|
+
attributes:
|
|
8
|
+
value: |
|
|
9
|
+
Have an idea to make LIATE faster, lighter, or more powerful? Let us know!
|
|
10
|
+
- type: textarea
|
|
11
|
+
id: problem
|
|
12
|
+
attributes:
|
|
13
|
+
label: "Problem or Need"
|
|
14
|
+
description: "Is your feature request related to a problem or limitation? Please describe."
|
|
15
|
+
placeholder: "I'm always frustrated when..."
|
|
16
|
+
validations:
|
|
17
|
+
required: true
|
|
18
|
+
- type: textarea
|
|
19
|
+
id: solution
|
|
20
|
+
attributes:
|
|
21
|
+
label: "Proposed Solution"
|
|
22
|
+
description: "How should this fit within the 5 layers: [L] · [I] · [A] · [T] · [E]?"
|
|
23
|
+
placeholder: "Add support for streaming token events in the [L] layer..."
|
|
24
|
+
validations:
|
|
25
|
+
required: true
|
|
26
|
+
- type: dropdown
|
|
27
|
+
id: layer
|
|
28
|
+
attributes:
|
|
29
|
+
label: "Affected Layer"
|
|
30
|
+
description: "Which LIATE layer does this feature target?"
|
|
31
|
+
options:
|
|
32
|
+
- "[L] LLM Layer"
|
|
33
|
+
- "[I] Integration Layer"
|
|
34
|
+
- "[A] Agent Layer"
|
|
35
|
+
- "[T] Tools Layer"
|
|
36
|
+
- "[E] Environment Layer"
|
|
37
|
+
- "Core / CLI"
|
|
38
|
+
validations:
|
|
39
|
+
required: true
|
liate-0.0.0/.gitignore
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Dependencies
|
|
2
|
+
node_modules/
|
|
3
|
+
.pnp
|
|
4
|
+
.pnp.js
|
|
5
|
+
|
|
6
|
+
# Environment variables
|
|
7
|
+
.env
|
|
8
|
+
.env.local
|
|
9
|
+
.env.development.local
|
|
10
|
+
.env.test.local
|
|
11
|
+
.env.production.local
|
|
12
|
+
|
|
13
|
+
# Build outputs
|
|
14
|
+
dist/
|
|
15
|
+
build/
|
|
16
|
+
out/
|
|
17
|
+
*.tsbuildinfo
|
|
18
|
+
|
|
19
|
+
# Python artifacts
|
|
20
|
+
__pycache__/
|
|
21
|
+
*.py[cod]
|
|
22
|
+
*$py.class
|
|
23
|
+
*.egg-info/
|
|
24
|
+
dist/
|
|
25
|
+
build/
|
|
26
|
+
.pytest_cache/
|
|
27
|
+
|
|
28
|
+
# Fern docs local cache
|
|
29
|
+
.fern/
|
|
30
|
+
|
|
31
|
+
# Logs
|
|
32
|
+
npm-debug.log*
|
|
33
|
+
yarn-debug.log*
|
|
34
|
+
yarn-error.log*
|
|
35
|
+
bun.lockb
|
|
36
|
+
pnpm-debug.log*
|
|
37
|
+
|
|
38
|
+
# OS Files
|
|
39
|
+
.DS_Store
|
|
40
|
+
Thumbs.db
|
liate-0.0.0/CHANGELOG.md
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to the **LIATE** runtime will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## [0.0.0] — Day 0 (2026-10-23) · *Stealth Mode Init*
|
|
11
|
+
|
|
12
|
+
> **Theme:** Liate Begin — The Open Source OOP AI Agent Runtime.
|
|
13
|
+
|
|
14
|
+
### Added
|
|
15
|
+
- **Core Architecture Specification:**
|
|
16
|
+
- Established the 5-layer unified agent abstraction:
|
|
17
|
+
- **L**[LM] — Model layer (India-first with Sarvam AI, OpenAI, Anthropic, Ollama).
|
|
18
|
+
- **I**[ntegration] — Context, session memory, and knowledge connectors.
|
|
19
|
+
- **A**[gent] — Name, system instructions, and goal routing.
|
|
20
|
+
- **T**[ools] — Model Context Protocol (MCP) server integration & tool execution.
|
|
21
|
+
- **E**[nvironment] — Configuration, keys, and edge runtime parameters.
|
|
22
|
+
- **Polyglot OOP Agent Interfaces:**
|
|
23
|
+
- Multi-language specification for TypeScript, JavaScript, Python, and Java.
|
|
24
|
+
- Zero-code `agent.json` declarative schema.
|
|
25
|
+
- **Documentation & Manifesto:**
|
|
26
|
+
- Initial `README.md` covering the *"Class is an Agent. Agent is an API"* philosophy.
|
|
27
|
+
- Sarvam AI Startup Program selection recognition.
|
|
28
|
+
- 3 Core Pillars: Build Your Own, BYOAI, and BYOC (Neon 1M free edge runs).
|
|
29
|
+
- **License:**
|
|
30
|
+
- Open-sourced under the MIT License.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
*Next milestone: Day 1 (2026-10-24) — Private Core Engine Build & Testing.*
|
liate-0.0.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Vinod Hatti (hello@liate.dev) and OpenLiate Contributors
|
|
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.
|
liate-0.0.0/PKG-INFO
ADDED
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: liate
|
|
3
|
+
Version: 0.0.0
|
|
4
|
+
Summary: Class is an Agent. Agent is an API. The Open Source AI Agent Runtime for OOP Architecture.
|
|
5
|
+
Project-URL: Homepage, https://liate.dev
|
|
6
|
+
Project-URL: Repository, https://github.com/solovinod/liate
|
|
7
|
+
Project-URL: Documentation, https://liate.dev
|
|
8
|
+
Author-email: Vinod Hatti <hello@liate.dev>
|
|
9
|
+
License-Expression: MIT
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
12
|
+
Classifier: Operating System :: OS Independent
|
|
13
|
+
Classifier: Programming Language :: Python :: 3
|
|
14
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
15
|
+
Requires-Python: >=3.10
|
|
16
|
+
Description-Content-Type: text/markdown
|
|
17
|
+
|
|
18
|
+
# LIATE — L[LM] · I[ntegration] · A[gent] · T[ools] · E[nvironment]
|
|
19
|
+
|
|
20
|
+
> **Class is an Agent. Agent is an API.**
|
|
21
|
+
|
|
22
|
+
## The Open Source AI Agent Runtime for OOP Architecture. 🇮🇳
|
|
23
|
+
|
|
24
|
+
> 🎉 **Liate is selected for the Sarvam AI Startup Program.**
|
|
25
|
+
> Built solo by Vinod Hatti ([@solovinod](https://github.com/solovinod))
|
|
26
|
+
|
|
27
|
+
Run Millions of AI Agents on Edge Cloud. Free Forever. Self Host.
|
|
28
|
+
Agent is a Function on Neon — 1,000,000 free runs/month on your own account.
|
|
29
|
+
|
|
30
|
+
If your language has a class — your class can be an AI Agent.
|
|
31
|
+
**Java · JavaScript · TypeScript · Python**
|
|
32
|
+
|
|
33
|
+
<p align="center">
|
|
34
|
+
<a href="https://liate.dev"><img src="https://img.shields.io/badge/docs-liate.dev-black.svg" alt="Docs"></a>
|
|
35
|
+
<a href="https://github.com/openliate/liate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License: MIT"></a>
|
|
36
|
+
<a href="https://sarvam.ai"><img src="https://img.shields.io/badge/powered%20by-Sarvam%20AI-orange" alt="Powered by Sarvam AI"></a>
|
|
37
|
+
<img src="https://img.shields.io/badge/version-0.0.0-blue" alt="v0.0.0">
|
|
38
|
+
</p>
|
|
39
|
+
|
|
40
|
+
<p align="center">
|
|
41
|
+
<strong>Run Locally</strong><br><br>
|
|
42
|
+
<a href="https://bun.sh"><img src="https://img.shields.io/badge/Bun-FBF0DF?logo=bun&logoColor=black" alt="Bun"></a>
|
|
43
|
+
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-339933?logo=node.js&logoColor=white" alt="Node.js"></a>
|
|
44
|
+
<a href="https://deno.com"><img src="https://img.shields.io/badge/Deno-000000?logo=deno&logoColor=white" alt="Deno"></a>
|
|
45
|
+
</p>
|
|
46
|
+
|
|
47
|
+
<p align="center">
|
|
48
|
+
<strong>Deploy Free — 1M Agent Runs/Month (BYOC)</strong><br><br>
|
|
49
|
+
<a href="https://neon.tech"><img src="https://img.shields.io/badge/Neon-00E59B?logo=neon&logoColor=black" alt="Neon"></a>
|
|
50
|
+
</p>
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
### Not a Framework. A Runtime.
|
|
55
|
+
|
|
56
|
+
Frameworks tell you how to write code.
|
|
57
|
+
A runtime **executes** your code.
|
|
58
|
+
|
|
59
|
+
Liate is the runtime for AI Agents.
|
|
60
|
+
You write a class. Liate runs it as an autonomous AI Agent — locally, on edge, or on your own cloud.
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
### The 3 Pillars
|
|
65
|
+
|
|
66
|
+
- 🛠️ **Build Your Own AI Agent** — Extend `LiateAgent`. Your class IS the agent and the API. Zero boilerplate.
|
|
67
|
+
- 🧠 **Bring Your Own AI (BYOAI)** — Plug in your own Sarvam AI key (`SARVAM_API_KEY`). Direct access, zero markup.
|
|
68
|
+
- ☁️ **Bring Your Own Cloud (BYOC)** — Connect your own Neon account. 1,000,000 free agent runs/month on your own infrastructure.
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
### Hello Agent ⚡
|
|
73
|
+
|
|
74
|
+
The frontier agent. One class. All 5 layers. Any OOP language.
|
|
75
|
+
|
|
76
|
+
**TypeScript**
|
|
77
|
+
```typescript
|
|
78
|
+
import { LiateAgent } from "liate";
|
|
79
|
+
|
|
80
|
+
class HelloAgent extends LiateAgent {
|
|
81
|
+
constructor() {
|
|
82
|
+
super({
|
|
83
|
+
L: "sarvam/sarvam-105b",
|
|
84
|
+
I: { memory: "sessions/hello" },
|
|
85
|
+
A: { name: "hello-agent", prompt: "You are HelloAgent." },
|
|
86
|
+
T: ["mcp/local"],
|
|
87
|
+
E: { SARVAM_API_KEY: process.env.SARVAM_API_KEY }
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
await new HelloAgent().run("Hello Agent World!");
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
**Java**
|
|
96
|
+
```java
|
|
97
|
+
import dev.liate.LiateAgent;
|
|
98
|
+
|
|
99
|
+
public class HelloAgent extends LiateAgent {
|
|
100
|
+
public HelloAgent() {
|
|
101
|
+
super(new AgentConfig()
|
|
102
|
+
.L("sarvam/sarvam-105b")
|
|
103
|
+
.I("sessions/hello")
|
|
104
|
+
.A("hello-agent", "You are HelloAgent.")
|
|
105
|
+
.T("mcp/local")
|
|
106
|
+
.E("SARVAM_API_KEY")
|
|
107
|
+
);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
new HelloAgent().run("Hello Agent World!");
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
**Python**
|
|
115
|
+
```python
|
|
116
|
+
from liate import LiateAgent
|
|
117
|
+
import os
|
|
118
|
+
|
|
119
|
+
class HelloAgent(LiateAgent):
|
|
120
|
+
def __init__(self):
|
|
121
|
+
super().__init__(
|
|
122
|
+
L="sarvam/sarvam-105b",
|
|
123
|
+
I={"memory": "sessions/hello"},
|
|
124
|
+
A={"name": "hello-agent", "prompt": "You are HelloAgent."},
|
|
125
|
+
T=["mcp/local"],
|
|
126
|
+
E={"SARVAM_API_KEY": os.environ["SARVAM_API_KEY"]}
|
|
127
|
+
)
|
|
128
|
+
|
|
129
|
+
await HelloAgent().run("Hello Agent World!")
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
**JavaScript**
|
|
133
|
+
```js
|
|
134
|
+
import { LiateAgent } from "liate";
|
|
135
|
+
|
|
136
|
+
class HelloAgent extends LiateAgent {
|
|
137
|
+
constructor() {
|
|
138
|
+
super({
|
|
139
|
+
L: "sarvam/sarvam-105b",
|
|
140
|
+
I: { memory: "sessions/hello" },
|
|
141
|
+
A: { name: "hello-agent", prompt: "You are HelloAgent." },
|
|
142
|
+
T: ["mcp/local"],
|
|
143
|
+
E: { SARVAM_API_KEY: process.env.SARVAM_API_KEY }
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
await new HelloAgent().run("Hello Agent World!");
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
Or zero-code with `agent.json`:
|
|
152
|
+
```json
|
|
153
|
+
{
|
|
154
|
+
"L": "sarvam/sarvam-105b",
|
|
155
|
+
"I": { "memory": "sessions/hello" },
|
|
156
|
+
"A": { "name": "hello-agent", "prompt": "You are HelloAgent." },
|
|
157
|
+
"T": ["mcp/local"],
|
|
158
|
+
"E": { "SARVAM_API_KEY": "$SARVAM_API_KEY" }
|
|
159
|
+
}
|
|
160
|
+
```
|
|
161
|
+
```bash
|
|
162
|
+
npx liate run agent.json "Hello Agent World!"
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
---
|
|
166
|
+
|
|
167
|
+
### Run on the fly
|
|
168
|
+
|
|
169
|
+
No project setup needed:
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
npx liate run "Analyze this repository and find performance bottlenecks"
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
### Deploy to Your Own Cloud (BYOC) 🚀
|
|
178
|
+
|
|
179
|
+
Deploy the Liate runtime engine directly into your own Neon account:
|
|
180
|
+
|
|
181
|
+
```bash
|
|
182
|
+
# Connect your own Neon account via OAuth
|
|
183
|
+
liate connect --neon
|
|
184
|
+
|
|
185
|
+
# Deploy Liate engine to your Neon account
|
|
186
|
+
liate deploy --neon
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
- Scale to Zero — zero cost when agents sleep.
|
|
190
|
+
- Neon Cron — scheduled agents wake up automatically.
|
|
191
|
+
- 1,000,000 free executions/month on your own account.
|
|
192
|
+
- Your data never leaves your own infrastructure.
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
### The LIATE Architecture
|
|
197
|
+
|
|
198
|
+
Every agent runs on 5 layers, declared as class properties:
|
|
199
|
+
|
|
200
|
+
```
|
|
201
|
+
+--------------------------------------------------+
|
|
202
|
+
| [L] LLM — Sarvam AI (India-First) |
|
|
203
|
+
+--------------------------------------------------+
|
|
204
|
+
| [I] Integration — Conversation Memory |
|
|
205
|
+
+--------------------------------------------------+
|
|
206
|
+
| [A] Agent — Name + Intent |
|
|
207
|
+
+--------------------------------------------------+
|
|
208
|
+
| [T] Tools — MCP Server Connector |
|
|
209
|
+
+--------------------------------------------------+
|
|
210
|
+
| [E] Environment — API Keys & Edge Runtime |
|
|
211
|
+
+--------------------------------------------------+
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
### The 5 Layers (L·I·A·T·E)
|
|
215
|
+
|
|
216
|
+
| Layer | Name | Day 1 | Community PRs |
|
|
217
|
+
|---|---|---|---|
|
|
218
|
+
| **L** | LLM | Sarvam AI (`hub/llm/sarvam.json`) 🇮🇳 | Add OpenAI, Claude, Gemini... |
|
|
219
|
+
| **I** | Integration | In-memory conversation state | Add Neon Postgres, Redis... |
|
|
220
|
+
| **A** | Agent | `LiateAgent` class — name, prompt, intent | Add ReAct, multi-agent... |
|
|
221
|
+
| **T** | Tools | Local MCP v2 (stdio) | Add remote MCP servers... |
|
|
222
|
+
| **E** | Environment | Pure `.env` key reader | Add edge isolate configs... |
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
### Contributing
|
|
227
|
+
|
|
228
|
+
Liate's core runtime is minimal and focused.
|
|
229
|
+
The **`hub/`** directory belongs to the community:
|
|
230
|
+
|
|
231
|
+
- Add a new LLM → PR to `hub/llm/`
|
|
232
|
+
- Share your agent → PR to `hub/agents/`
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
### License
|
|
237
|
+
|
|
238
|
+
[MIT](LICENSE) © 2026 Vinod Hatti ([@solovinod](https://github.com/solovinod)). Free and open source forever.
|
liate-0.0.0/README.md
ADDED
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
# LIATE — L[LM] · I[ntegration] · A[gent] · T[ools] · E[nvironment]
|
|
2
|
+
|
|
3
|
+
> **Class is an Agent. Agent is an API.**
|
|
4
|
+
|
|
5
|
+
## The Open Source AI Agent Runtime for OOP Architecture. 🇮🇳
|
|
6
|
+
|
|
7
|
+
> 🎉 **Liate is selected for the Sarvam AI Startup Program.**
|
|
8
|
+
> Built solo by Vinod Hatti ([@solovinod](https://github.com/solovinod))
|
|
9
|
+
|
|
10
|
+
Run Millions of AI Agents on Edge Cloud. Free Forever. Self Host.
|
|
11
|
+
Agent is a Function on Neon — 1,000,000 free runs/month on your own account.
|
|
12
|
+
|
|
13
|
+
If your language has a class — your class can be an AI Agent.
|
|
14
|
+
**Java · JavaScript · TypeScript · Python**
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<a href="https://liate.dev"><img src="https://img.shields.io/badge/docs-liate.dev-black.svg" alt="Docs"></a>
|
|
18
|
+
<a href="https://github.com/openliate/liate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License: MIT"></a>
|
|
19
|
+
<a href="https://sarvam.ai"><img src="https://img.shields.io/badge/powered%20by-Sarvam%20AI-orange" alt="Powered by Sarvam AI"></a>
|
|
20
|
+
<img src="https://img.shields.io/badge/version-0.0.0-blue" alt="v0.0.0">
|
|
21
|
+
</p>
|
|
22
|
+
|
|
23
|
+
<p align="center">
|
|
24
|
+
<strong>Run Locally</strong><br><br>
|
|
25
|
+
<a href="https://bun.sh"><img src="https://img.shields.io/badge/Bun-FBF0DF?logo=bun&logoColor=black" alt="Bun"></a>
|
|
26
|
+
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-339933?logo=node.js&logoColor=white" alt="Node.js"></a>
|
|
27
|
+
<a href="https://deno.com"><img src="https://img.shields.io/badge/Deno-000000?logo=deno&logoColor=white" alt="Deno"></a>
|
|
28
|
+
</p>
|
|
29
|
+
|
|
30
|
+
<p align="center">
|
|
31
|
+
<strong>Deploy Free — 1M Agent Runs/Month (BYOC)</strong><br><br>
|
|
32
|
+
<a href="https://neon.tech"><img src="https://img.shields.io/badge/Neon-00E59B?logo=neon&logoColor=black" alt="Neon"></a>
|
|
33
|
+
</p>
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
### Not a Framework. A Runtime.
|
|
38
|
+
|
|
39
|
+
Frameworks tell you how to write code.
|
|
40
|
+
A runtime **executes** your code.
|
|
41
|
+
|
|
42
|
+
Liate is the runtime for AI Agents.
|
|
43
|
+
You write a class. Liate runs it as an autonomous AI Agent — locally, on edge, or on your own cloud.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
### The 3 Pillars
|
|
48
|
+
|
|
49
|
+
- 🛠️ **Build Your Own AI Agent** — Extend `LiateAgent`. Your class IS the agent and the API. Zero boilerplate.
|
|
50
|
+
- 🧠 **Bring Your Own AI (BYOAI)** — Plug in your own Sarvam AI key (`SARVAM_API_KEY`). Direct access, zero markup.
|
|
51
|
+
- ☁️ **Bring Your Own Cloud (BYOC)** — Connect your own Neon account. 1,000,000 free agent runs/month on your own infrastructure.
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
### Hello Agent ⚡
|
|
56
|
+
|
|
57
|
+
The frontier agent. One class. All 5 layers. Any OOP language.
|
|
58
|
+
|
|
59
|
+
**TypeScript**
|
|
60
|
+
```typescript
|
|
61
|
+
import { LiateAgent } from "liate";
|
|
62
|
+
|
|
63
|
+
class HelloAgent extends LiateAgent {
|
|
64
|
+
constructor() {
|
|
65
|
+
super({
|
|
66
|
+
L: "sarvam/sarvam-105b",
|
|
67
|
+
I: { memory: "sessions/hello" },
|
|
68
|
+
A: { name: "hello-agent", prompt: "You are HelloAgent." },
|
|
69
|
+
T: ["mcp/local"],
|
|
70
|
+
E: { SARVAM_API_KEY: process.env.SARVAM_API_KEY }
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
await new HelloAgent().run("Hello Agent World!");
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
**Java**
|
|
79
|
+
```java
|
|
80
|
+
import dev.liate.LiateAgent;
|
|
81
|
+
|
|
82
|
+
public class HelloAgent extends LiateAgent {
|
|
83
|
+
public HelloAgent() {
|
|
84
|
+
super(new AgentConfig()
|
|
85
|
+
.L("sarvam/sarvam-105b")
|
|
86
|
+
.I("sessions/hello")
|
|
87
|
+
.A("hello-agent", "You are HelloAgent.")
|
|
88
|
+
.T("mcp/local")
|
|
89
|
+
.E("SARVAM_API_KEY")
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
new HelloAgent().run("Hello Agent World!");
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
**Python**
|
|
98
|
+
```python
|
|
99
|
+
from liate import LiateAgent
|
|
100
|
+
import os
|
|
101
|
+
|
|
102
|
+
class HelloAgent(LiateAgent):
|
|
103
|
+
def __init__(self):
|
|
104
|
+
super().__init__(
|
|
105
|
+
L="sarvam/sarvam-105b",
|
|
106
|
+
I={"memory": "sessions/hello"},
|
|
107
|
+
A={"name": "hello-agent", "prompt": "You are HelloAgent."},
|
|
108
|
+
T=["mcp/local"],
|
|
109
|
+
E={"SARVAM_API_KEY": os.environ["SARVAM_API_KEY"]}
|
|
110
|
+
)
|
|
111
|
+
|
|
112
|
+
await HelloAgent().run("Hello Agent World!")
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
**JavaScript**
|
|
116
|
+
```js
|
|
117
|
+
import { LiateAgent } from "liate";
|
|
118
|
+
|
|
119
|
+
class HelloAgent extends LiateAgent {
|
|
120
|
+
constructor() {
|
|
121
|
+
super({
|
|
122
|
+
L: "sarvam/sarvam-105b",
|
|
123
|
+
I: { memory: "sessions/hello" },
|
|
124
|
+
A: { name: "hello-agent", prompt: "You are HelloAgent." },
|
|
125
|
+
T: ["mcp/local"],
|
|
126
|
+
E: { SARVAM_API_KEY: process.env.SARVAM_API_KEY }
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
await new HelloAgent().run("Hello Agent World!");
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
Or zero-code with `agent.json`:
|
|
135
|
+
```json
|
|
136
|
+
{
|
|
137
|
+
"L": "sarvam/sarvam-105b",
|
|
138
|
+
"I": { "memory": "sessions/hello" },
|
|
139
|
+
"A": { "name": "hello-agent", "prompt": "You are HelloAgent." },
|
|
140
|
+
"T": ["mcp/local"],
|
|
141
|
+
"E": { "SARVAM_API_KEY": "$SARVAM_API_KEY" }
|
|
142
|
+
}
|
|
143
|
+
```
|
|
144
|
+
```bash
|
|
145
|
+
npx liate run agent.json "Hello Agent World!"
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
### Run on the fly
|
|
151
|
+
|
|
152
|
+
No project setup needed:
|
|
153
|
+
|
|
154
|
+
```bash
|
|
155
|
+
npx liate run "Analyze this repository and find performance bottlenecks"
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
### Deploy to Your Own Cloud (BYOC) 🚀
|
|
161
|
+
|
|
162
|
+
Deploy the Liate runtime engine directly into your own Neon account:
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
# Connect your own Neon account via OAuth
|
|
166
|
+
liate connect --neon
|
|
167
|
+
|
|
168
|
+
# Deploy Liate engine to your Neon account
|
|
169
|
+
liate deploy --neon
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
- Scale to Zero — zero cost when agents sleep.
|
|
173
|
+
- Neon Cron — scheduled agents wake up automatically.
|
|
174
|
+
- 1,000,000 free executions/month on your own account.
|
|
175
|
+
- Your data never leaves your own infrastructure.
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
### The LIATE Architecture
|
|
180
|
+
|
|
181
|
+
Every agent runs on 5 layers, declared as class properties:
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
+--------------------------------------------------+
|
|
185
|
+
| [L] LLM — Sarvam AI (India-First) |
|
|
186
|
+
+--------------------------------------------------+
|
|
187
|
+
| [I] Integration — Conversation Memory |
|
|
188
|
+
+--------------------------------------------------+
|
|
189
|
+
| [A] Agent — Name + Intent |
|
|
190
|
+
+--------------------------------------------------+
|
|
191
|
+
| [T] Tools — MCP Server Connector |
|
|
192
|
+
+--------------------------------------------------+
|
|
193
|
+
| [E] Environment — API Keys & Edge Runtime |
|
|
194
|
+
+--------------------------------------------------+
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
### The 5 Layers (L·I·A·T·E)
|
|
198
|
+
|
|
199
|
+
| Layer | Name | Day 1 | Community PRs |
|
|
200
|
+
|---|---|---|---|
|
|
201
|
+
| **L** | LLM | Sarvam AI (`hub/llm/sarvam.json`) 🇮🇳 | Add OpenAI, Claude, Gemini... |
|
|
202
|
+
| **I** | Integration | In-memory conversation state | Add Neon Postgres, Redis... |
|
|
203
|
+
| **A** | Agent | `LiateAgent` class — name, prompt, intent | Add ReAct, multi-agent... |
|
|
204
|
+
| **T** | Tools | Local MCP v2 (stdio) | Add remote MCP servers... |
|
|
205
|
+
| **E** | Environment | Pure `.env` key reader | Add edge isolate configs... |
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
### Contributing
|
|
210
|
+
|
|
211
|
+
Liate's core runtime is minimal and focused.
|
|
212
|
+
The **`hub/`** directory belongs to the community:
|
|
213
|
+
|
|
214
|
+
- Add a new LLM → PR to `hub/llm/`
|
|
215
|
+
- Share your agent → PR to `hub/agents/`
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
### License
|
|
220
|
+
|
|
221
|
+
[MIT](LICENSE) © 2026 Vinod Hatti ([@solovinod](https://github.com/solovinod)). Free and open source forever.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["hatchling"]
|
|
3
|
+
build-backend = "hatchling.build"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "liate"
|
|
7
|
+
version = "0.0.0"
|
|
8
|
+
description = "Class is an Agent. Agent is an API. The Open Source AI Agent Runtime for OOP Architecture."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.10"
|
|
11
|
+
license = "MIT"
|
|
12
|
+
authors = [
|
|
13
|
+
{ name = "Vinod Hatti", email = "hello@liate.dev" }
|
|
14
|
+
]
|
|
15
|
+
classifiers = [
|
|
16
|
+
"Programming Language :: Python :: 3",
|
|
17
|
+
"License :: OSI Approved :: MIT License",
|
|
18
|
+
"Operating System :: OS Independent",
|
|
19
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence"
|
|
20
|
+
]
|
|
21
|
+
|
|
22
|
+
[project.urls]
|
|
23
|
+
Homepage = "https://liate.dev"
|
|
24
|
+
Repository = "https://github.com/solovinod/liate"
|
|
25
|
+
Documentation = "https://liate.dev"
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Liate [L-I-A-T-E] — India's Open Source Runtime For AI Agents 🇮🇳
|
|
3
|
+
"Class is an Agent. Agent is an API."
|
|
4
|
+
https://liate.dev
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
__version__ = "0.0.0"
|
|
8
|
+
__author__ = "Vinod Hatti <hello@liate.dev>"
|
|
9
|
+
|
|
10
|
+
class Agent:
|
|
11
|
+
"""
|
|
12
|
+
The Universal Base Class for OOP AI Agents.
|
|
13
|
+
5 Orthogonal Layers: L (LLM), I (Integration), A (Agent), T (Tools), E (Environment).
|
|
14
|
+
"""
|
|
15
|
+
L = None
|
|
16
|
+
I = None
|
|
17
|
+
A = None
|
|
18
|
+
T = None
|
|
19
|
+
E = None
|
|
20
|
+
|
|
21
|
+
def __init__(self, **kwargs):
|
|
22
|
+
for k, v in kwargs.items():
|
|
23
|
+
setattr(self, k, v)
|
|
24
|
+
|
|
25
|
+
def run(self, prompt: str):
|
|
26
|
+
"""Execute the agent ReAct reasoning loop."""
|
|
27
|
+
return f"Liate Agent ({self.__class__.__name__}) initialized with prompt: {prompt}"
|
|
28
|
+
|
|
29
|
+
__all__ = ["Agent", "__version__"]
|