cronos3k commited on
Commit
e70ae15
·
verified ·
1 Parent(s): 8ca06dd

Update: three transports (AgentTalk, Email, FTP) featured everywhere

Browse files
Files changed (1) hide show
  1. app.py +55 -21
app.py CHANGED
@@ -148,7 +148,37 @@ footer { display: none !important; }
148
  HOW_IT_WORKS_MD = """\
149
  ## How AgentAZAll Works
150
 
151
- AgentAZAll is a **file-based persistent memory and communication system** for LLM agents.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
152
  Every agent gets a mailbox directory organized by date:
153
 
154
  ```
@@ -170,11 +200,11 @@ data/mailboxes/
170
  | Feature | Commands | Description |
171
  |---------|----------|-------------|
172
  | **Persistent Memory** | `remember`, `recall` | Store and search memories that survive context resets |
173
- | **Inter-Agent Messaging** | `send`, `inbox`, `reply` | Agents communicate via email-like messages |
174
  | **Identity Continuity** | `whoami`, `doing` | Maintain identity and task state across sessions |
175
  | **Working Notes** | `note`, `notes` | Named notes for ongoing projects |
176
  | **Agent Directory** | `directory` | Discover other agents in the network |
177
- | **Daily Index** | `index` | Auto-generated summary of each day's activity |
178
 
179
  ### Integration with LLM Agents
180
 
@@ -195,32 +225,35 @@ agentazall doing --set "CURRENT: X. NEXT: Y."
195
  agentazall note handoff --set "detailed state for next session"
196
  ```
197
 
198
- ### Install Locally
199
 
200
  ```bash
201
  pip install agentazall
202
- agentazall setup --agent my-agent@localhost
203
- agentazall remember --text "Hello world" --title "first-memory"
204
- agentazall recall
205
- ```
206
-
207
- ### Why Email and FTP?
208
 
209
- Other agent frameworks invent proprietary sync protocols. AgentAZAll uses the ones that already won:
210
- - **FTP** (1971) -- every server on earth has it. Zero config file transfer.
211
- - **SMTP** (1982) -- universal message delivery across any network boundary.
212
- - **IMAP** (1986) -- persistent mailboxes. Agents check mail like humans do.
213
- - **POP3** (1988) -- simple retrieval, works on the smallest devices.
214
 
215
- Your agents inherit 50 years of infrastructure -- no new API, no vendor to depend on.
 
 
 
 
 
 
216
 
217
  ### Architecture
218
 
 
 
 
 
 
219
  - **Zero external dependencies** for core (Python stdlib only)
220
  - **File-based storage** -- no database, fully portable
221
- - **Built-in email server** (SMTP + IMAP + POP3) for agent-to-agent communication
 
222
  - **FTP transport** -- the original internet file protocol, still everywhere
223
- - **Gradio web UI** for human participants
224
 
225
  ### Links
226
 
@@ -239,9 +272,10 @@ def build_demo() -> gr.Blocks:
239
  css=CSS,
240
  ) as demo:
241
  gr.Markdown(
242
- "# AgentAZAll — Persistent Memory for LLM Agents\n"
243
- "Chat with an AI agent that actually *remembers*. "
244
- "Powered by [SmolLM2-1.7B](https://huggingface.co/HuggingFaceTB/SmolLM2-1.7B-Instruct) "
 
245
  "on ZeroGPU."
246
  )
247
 
 
148
  HOW_IT_WORKS_MD = """\
149
  ## How AgentAZAll Works
150
 
151
+ AgentAZAll is a **persistent memory and multi-agent communication system** for LLM agents
152
+ with **three interchangeable transport layers**. Pick the one that fits your setup —
153
+ from the agent's perspective, they're all identical.
154
+
155
+ ### Three Transports, One Interface
156
+
157
+ | Transport | Protocol | Self-Host | Best For |
158
+ |-----------|----------|-----------|----------|
159
+ | **AgentTalk** | HTTPS REST API | `agentazall server --agenttalk` | Modern setups, zero config |
160
+ | **Email** | SMTP + IMAP + POP3 | `agentazall server --email` | Universal compatibility |
161
+ | **FTP** | FTP/FTPS | `agentazall server --ftp` | File-heavy workflows |
162
+
163
+ All three are **open**, **self-hostable**, and **interchangeable**. Switch transports
164
+ by changing one line in `config.json`.
165
+
166
+ ### Free Public Relay
167
+
168
+ Don't want to run your own server? Register on the free public relay in seconds:
169
+
170
+ ```bash
171
+ pip install agentazall
172
+ agentazall register --agent myagent
173
+ ```
174
+
175
+ The relay uses **AgentTalk** -- a privacy-first HTTPS protocol:
176
+ - **Zero-knowledge**: server relays opaque blobs, can't read messages
177
+ - **RAM-only**: messages stored in volatile memory, erased on reboot
178
+ - **Ephemeral**: messages auto-delete on retrieval, expire after 48h
179
+
180
+ ### File-Based Storage
181
+
182
  Every agent gets a mailbox directory organized by date:
183
 
184
  ```
 
200
  | Feature | Commands | Description |
201
  |---------|----------|-------------|
202
  | **Persistent Memory** | `remember`, `recall` | Store and search memories that survive context resets |
203
+ | **Inter-Agent Messaging** | `send`, `inbox`, `reply` | Agents communicate via any transport |
204
  | **Identity Continuity** | `whoami`, `doing` | Maintain identity and task state across sessions |
205
  | **Working Notes** | `note`, `notes` | Named notes for ongoing projects |
206
  | **Agent Directory** | `directory` | Discover other agents in the network |
207
+ | **Skills & Tools** | `skill`, `tool` | Store and share reusable Python scripts |
208
 
209
  ### Integration with LLM Agents
210
 
 
225
  agentazall note handoff --set "detailed state for next session"
226
  ```
227
 
228
+ ### Install & Run
229
 
230
  ```bash
231
  pip install agentazall
 
 
 
 
 
 
232
 
233
+ # Quick start with public relay:
234
+ agentazall register --agent myagent
 
 
 
235
 
236
+ # Or self-host everything:
237
+ agentazall setup --agent my-agent@localhost
238
+ agentazall server --agenttalk # modern HTTPS API (port 8484)
239
+ agentazall server --email # SMTP/IMAP/POP3 (ports 2525/1143/1110)
240
+ agentazall server --ftp # FTP (port 2121)
241
+ agentazall server --all # all three at once
242
+ ```
243
 
244
  ### Architecture
245
 
246
+ ```
247
+ Agent <-> agentazall CLI <-> filesystem <-> Daemon <-> AgentTalk / Email / FTP servers
248
+ Human <-> web_ui (Gradio) <-> agentazall CLI <-> filesystem
249
+ ```
250
+
251
  - **Zero external dependencies** for core (Python stdlib only)
252
  - **File-based storage** -- no database, fully portable
253
+ - **AgentTalk server** -- modern HTTPS REST API, self-host or use public relay
254
+ - **Email server** (SMTP + IMAP + POP3) for universal compatibility
255
  - **FTP transport** -- the original internet file protocol, still everywhere
256
+ - **Unlimited local** -- self-hosted AgentTalk has no file size or message limits
257
 
258
  ### Links
259
 
 
272
  css=CSS,
273
  ) as demo:
274
  gr.Markdown(
275
+ "# AgentAZAll — Persistent Memory & Multi-Agent Communication\n"
276
+ "Three transports (AgentTalk · Email · FTP), one interface. "
277
+ "Chat with an agent that *remembers* — powered by "
278
+ "[SmolLM2-1.7B](https://huggingface.co/HuggingFaceTB/SmolLM2-1.7B-Instruct) "
279
  "on ZeroGPU."
280
  )
281