Spaces:
Sleeping
Sleeping
Update: three transports (AgentTalk, Email, FTP) featured everywhere
Browse files
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 **
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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
|
| 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 |
-
| **
|
| 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
|
| 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 |
-
|
| 210 |
-
|
| 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 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 216 |
|
| 217 |
### Architecture
|
| 218 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 219 |
- **Zero external dependencies** for core (Python stdlib only)
|
| 220 |
- **File-based storage** -- no database, fully portable
|
| 221 |
-
- **
|
|
|
|
| 222 |
- **FTP transport** -- the original internet file protocol, still everywhere
|
| 223 |
-
- **
|
| 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
|
| 243 |
-
"
|
| 244 |
-
"
|
|
|
|
| 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 |
|