Metadata-Version: 2.4
Name: svarog-forge
Version: 2.2.0
Summary: Forge. The smithy itself — AI-powered project forge from idea to deployment.
Project-URL: Homepage, https://github.com/SvarogForge/forge
Project-URL: Repository, https://github.com/SvarogForge/forge
Project-URL: Talaria, https://github.com/SvarogForge/talaria
Project-URL: Crucible, https://github.com/SvarogForge/crucible
Author-email: iMonstra <imonstra@users.noreply.github.com>
License: MIT
License-File: LICENSE
Keywords: ai,forge,hermes-agent,multi-agent,orchestration,svarog
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
Classifier: Topic :: Software Development :: Build Tools
Provides-Extra: all
Requires-Dist: svarog-crucible>=0.1.0; extra == 'all'
Requires-Dist: svarog-talaria>=0.1.0; extra == 'all'
Provides-Extra: crucible
Requires-Dist: svarog-crucible>=0.1.0; extra == 'crucible'
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Provides-Extra: talaria
Requires-Dist: svarog-talaria>=0.1.0; extra == 'talaria'
Description-Content-Type: text/markdown

<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>

# ⚒️ Forge — Your AI Smithy

> **The forge itself. Your AI smithy — from raw idea to forged tool.**
> *In Slavic lore, Svarog's forge birthed the sun, the plow, and the sword. Ours births microservices, bots, and dashboards.*

Forge is a [Hermes Agent](https://hermes-agent.nousresearch.com) skill that turns **"I want..."** into a complete project lifecycle:

1. 🔍 **Scout** — dispatches Talaria messengers to research the market, competitors, and demand
2. 📊 **Report** — gives you a clear "build / don't build" recommendation with evidence
3. ✅ **Your OK** — you greenlight, Forge assembles the team
4. ⚒️ **Forge** — specialized sub-agents execute: CEO strategy, SMM marketing, Security audit, Designer visual, Debug quality, and core development
5. 🔥 **Deliver** — output verified by Crucible, delivered with docs

[![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/forge?style=flat-square&logo=github)](https://github.com/SvarogForge/forge)
[![Last commit](https://img.shields.io/github/last-commit/SvarogForge/forge?style=flat-square&logo=github)](https://github.com/SvarogForge/forge)
[![License](https://img.shields.io/badge/license-MIT-green?style=flat)](LICENSE)
[![CI](https://github.com/SvarogForge/forge/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/SvarogForge/forge/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>

---

## 📦 Install

```bash
# The whole SvarogForge family
pip install svarog-forge

# Or install as a Hermes skill
git clone https://github.com/SvarogForge/forge.git
hermes skill install ./forge
```

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

---

## 🏭 How it works

```
You: "I want a Telegram bot for my SaaS that tracks GitHub stars"
 │
 ├── 🔍 SCOUT (Talaria) → 3 parallel scouts research market + competitors + demand
 │
 ├── 📊 GATE REPORT → "Market has 3 competitors. Niche is hot. Build: YES"
 │   └── Wait for your ✅ OK
 │
 ├── ⚒️ ASSEMBLE →
 │   ├── CEO Agent     — strategy, OKR, roadmap, risks
 │   ├── SMM Agent     — launch plan, channels, messaging
 │   ├── Security Agent — OWASP audit, dependency check
 │   ├── Designer Agent — logo, palette, visual identity
 │   ├── Debug Master   — test strategy, CI/CD, coverage
 │   └── My hands       — backend, frontend, quick-fixes
 │
 ├── 🔥 CRUCIBLE → verification checklist (code, docs, security, CI)
 │
 └── 🚀 DELIVER → release + docs + memory updated
```

---

## 📁 What's in the box

```
forge/
├── SKILL.md               — Hermes Agent skill (main artifact)
├── forge.py                — CLI orchestrator
├── forge-verify.py         — Project structure verifier
├── forge.yaml              — Configuration
├── LICENSE                 — MIT
├── SECURITY.md             — Security policy
├── CONTRIBUTING.md         — Contribution guidelines
├── CHANGELOG.md            — Version history
├── .gitignore
├── .github/workflows/ci.yml — GitHub Actions CI
└── README.md               — This file
```

---

## 🚀 Quick start

```bash
# Check status
python forge.py --status

# Verify project structure
python forge-verify.py

# Start a new project (via Hermes Agent)
# Say: "Кузница, сделай [идея]"
```

---

## 🧠 The 5-Phase Pipeline

| Phase | Name | What happens | Gate |
|:-----:|------|-------------|:----:|
| 1 | 🔍 **Scout** | 3 Talaria scouts research market, competitors, demand | — |
| 2 | 📊 **Gate** | Synthesized report with recommendation | ✅ Your OK |
| 3 | ⚒️ **Assemble** | 5 sub-agents + hands-on fixes in parallel | — |
| 4 | 🔥 **Crucible** | Verification checklist (code, docs, CI, security) | — |
| 5 | 🚀 **Deliver** | Release, README, PyPI, memory update | — |

---

## ⚙️ Configuration

Edit `forge.yaml` to customize:

```yaml
delegation:
  max_concurrent_children: 5
  max_spawn_depth: 2

timeout:
  ok_gate_hours: 24           # Auto-pause if no response
  subagent_timeout_minutes: 30
```

---

## 🔧 CLI Usage

```bash
# Check pipeline status
python forge.py --status

# Full cycle
python forge.py --plan "Telegram bot for tracking GitHub stars"

# Scout-only (skip assembly)
python forge.py --plan "..." --scout-only

# Resume from a phase
python forge.py --resume crucible
```

---

## 🔥 From the forge-fire

Forge 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 |
| 🔥 **Crucible** | Touchstone for quality & benchmarks |
| ⚒️ **Forge** | The smithy itself — AI-powered project forge (you are here) |

Created by [iMonstra](https://github.com/iMonstra)

---

<p align="center">
  ⭐ <b>Star on <a href="https://github.com/SvarogForge/forge">GitHub</a></b> ·
  🐦 <b><a href="https://twitter.com/iMonstra">Follow @iMonstra</a></b> ·
  💬 <b><a href="https://github.com/SvarogForge/forge/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>
