Metadata-Version: 2.4
Name: svarog-talaria
Version: 0.1.0
Summary: Talaria. Seven-league messengers — parallel sub-agents for deep multi-source research.
Project-URL: Homepage, https://github.com/SvarogForge/talaria
Project-URL: Repository, https://github.com/SvarogForge/talaria
Author-email: iMonstra <imonstra@users.noreply.github.com>
License: MIT
License-File: LICENSE
Keywords: ai,hermes-agent,multi-agent,svarog,talaria
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Description-Content-Type: text/markdown

<p align="center">
  <img src="assets/talaria-logo.png" width="400" alt="Talaria Logo">
</p>

<p align="center">
  <a href="https://github.com/SvarogForge"><img src="https://img.shields.io/badge/SvarogForge-Forged-8A2BE2?style=flat-square" alt="SvarogForge"></a>
</p>

# ⚡ Talaria — Parallel Messengers for Hermes Agent

> *Talaria (Ταλάρια) — the winged sandals, forged in Svarog's smithy, swift as seven-league boots of legend.*
> *One stride carries your AI messengers across every source at once, bringing back intelligence.*

**Talaria** is a [Hermes Agent](https://hermes-agent.nousresearch.com) skill that dispatches **3-5 parallel sub-agents** for deep multi-source research, then verifies and synthesizes results into a single report.

[![EN](https://img.shields.io/badge/EN-English-blue?style=flat-square)](README.md)
[![RU](https://img.shields.io/badge/RU-Русский-red?style=flat-square)](README.ru.md)

[![Stars](https://img.shields.io/github/stars/SvarogForge/talaria?style=flat-square&logo=github)](https://github.com/SvarogForge/talaria)
[![Last commit](https://img.shields.io/github/last-commit/SvarogForge/talaria?style=flat-square&logo=github)](https://github.com/SvarogForge/talaria)
[![License](https://img.shields.io/badge/license-MIT-green?style=flat)](LICENSE)
[![CI](https://github.com/SvarogForge/talaria/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/SvarogForge/talaria/actions/workflows/ci.yml)
[![Hermes Skill](https://img.shields.io/badge/Hermes-Skill-8A2BE2?style=flat)](https://hermes-agent.nousresearch.com)

<p align="center">
  <img src="https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python">
  <img src="https://img.shields.io/badge/JSON-000000?style=flat-square&logo=json&logoColor=white" alt="JSON">
  <img src="https://img.shields.io/badge/Markdown-000000?style=flat-square&logo=markdown&logoColor=white" alt="Markdown">
  <img src="https://img.shields.io/badge/GitHub%20Actions-2088FF?style=flat-square&logo=githubactions&logoColor=white" alt="GitHub Actions">
</p>

---

## 💡 Why Talaria?

**Problem:** Deep research takes forever when you query one source at a time. Each search → read → repeat cycle costs minutes.

**Solution:** Talaria dispatches **3–5 parallel sub-agents** — each with its own research axis, tools, and context. They run simultaneously, then **verify** and **synthesize** results into one report. What took 15 minutes now takes 2.

### Talaria vs. Raw `delegate_task`

| Feature | `delegate_task` (bare) | ⚡ Talaria |
|---------|------------------------|:----------:|
| 🛡️ Anti-hallucination | ❌ You build it | ✅ `verify-report.py` with 4 profiles |
| 🔄 Cascade search | ❌ Manual fallback | ✅ 4-tier auto (GitHub→raw→API→browser) |
| 🧠 Smart synthesis | ❌ You merge manually | ✅ Intersections + contradictions + insights |
| 🔒 Safe sub-agents | ❌ No guardrails | ✅ 6 blocked tools |
| 📊 Benchmark data | ❌ None | ✅ Preliminary: 2.5 min flat, 7.2 min nested |
| 💾 Output structure | ❌ Ad-hoc | ✅ `reports/gonets*.md` + `synthesis*.md` |

## 🎯 Quick Start

```bash
# Install in 30 seconds
git clone https://github.com/SvarogForge/talaria.git
hermes skill install ./talaria
```

Then load in your session:
```python
skill_view(name='talaria')
```

```python
# Verify it works
python talaria/verify-report.py --list-profiles
# → default, strict, tech, quick
```

## 🏛️ How It Works

```mermaid
flowchart TB
    A["💬 User asks research question"] --> B["⚡ Talaria dispatches 3-5 messengers"]
    B --> C1["📡 Messenger 1<br/>GitHub API + Browser"]
    B --> C2["📡 Messenger 2<br/>HuggingFace + Direct APIs"]
    B --> C3["📡 Messenger 3<br/>Browser + Curl"]
    C1 --> D["🔍 verify-report.py<br/>checks for hallucinations"]
    C2 --> D
    C3 --> D
    D --> E["🧠 Synthesis → One report<br/>with intersections & insights"]
    E --> F["📬 Executive summary → you<br/>Full report → reports/*.md"]
```

| Step | What Happens |
|:----:|--------------|
| 1️⃣ | **DISPATCH** — 3-5 messengers `delegate_task` in parallel |
| 2️⃣ | **RESEARCH** — each uses GitHub API, browser, or direct APIs |
| 3️⃣ | **VERIFY** — cross-check against trusted domains |
| 4️⃣ | **SYNTHESIZE** — merge findings, find contradictions |
| 5️⃣ | **DELIVER** — Full report + executive summary |

## 🎬 In Action

<p align="center">
  <img src="assets/talaria-demo.svg" width="700" alt="Talaria Terminal Demo">
  <br>
  <em>3 messengers dispatched → verified → synthesized in 2.3 minutes</em>
</p>

## ✨ Key Features

| Feature | Description |
|---------|-------------|
| ⚡ **Parallel Dispatch** | 3-5 messengers run simultaneously |
| 🛡️ **Anti-Hallucination** | Cross-verification, fake detection, URL validation |
| 🔄 **Cascade Search** | Falls through GitHub → browser → direct APIs |
| 📊 **Smart Synthesis** | Finds intersections, contradictions, insights |
| 🧹 **Clean Research** | All examples are technical research |
| 🔒 **Safe Sub-Agents** | 6 blocked tools prevent harm |

## 📦 What's Included

```
talaria/
├── SKILL.md              — Full skill documentation
├── verify-report.py      — Anti-hallucination checker (4 profiles)
├── references/
│   ├── architecture.md       — Dispatch & 6 unique features
│   ├── working-apis.md       — API endpoints (no proxy)
│   └── anti-hallucination.md — Detection guide
├── examples/
│   ├── 01-market-research.py
│   ├── 02-tech-audit.py
│   ├── 03-pricing.py
│   └── 04-trends.py
├── README.md              — This file
├── README.ru.md           — Russian version
└── LICENSE                — MIT
```

## 📋 Example Output

When Talaria finishes, you get:

```
🔍  TALARIA VERIFICATION — messenger report validation
======================================================================
reports/gonets1_market.md:
  Status: ✅ REAL DATA  (profile: tech)
  URLs total: 12, real: 8
  Sources: github.com, huggingface.co, pypi.org
  Code: ✅ | Tables: ✅ | Lists: ✅

✅ All messengers returned REAL data!

📊 SYNTHESIS — Key findings:
  • Top 3 AI frameworks by GitHub stars (ranked)
  • 2 contradictions flagged (data age mismatch)
  • Pricing table: DeepSeek $0.14 vs GPT-4o $2.50 per 1M tokens
```

## 🔥 From the forge-fire

Talaria is part of [SvarogForge](https://github.com/SvarogForge) — a family of tools forged for Hermes Agent.

| Project | Description |
|---------|-------------|
| ⚡ **Talaria** | Seven-league messengers for market research (you are here) |
| 🔥 **Crucible** | Touchstone for quality & benchmarks |
| ⚒️ **Forge** | The smithy itself — AI-powered project forge |

## 📄 License

MIT — see [LICENSE](LICENSE)

---

<p align="center">
  ⭐ <b>Star on <a href="https://github.com/SvarogForge/talaria">GitHub</a></b> · 
  🐦 <b><a href="https://twitter.com/iMonstra">Follow @iMonstra</a></b> · 
  💬 <b><a href="https://github.com/SvarogForge/talaria/discussions">Join Discussions</a></b>
</p>
<p align="center">Built for <a href="https://hermes-agent.nousresearch.com">Hermes Agent</a> · <a href="LICENSE">MIT</a> · Contributions welcome</p>
