https://github.com/agentlas-ai/hephaestus

No-code AI agent builder — turn one sentence into a single agent or a multi-agent team. The engine inside Agentlas. A no-code CrewAI / LangGraph / AutoGen alternative that runs on Claude Code, Codex, and Cursor.
https://github.com/agentlas-ai/hephaestus
agent-framework agentic-ai ai-agent-builder ai-agents autogen claude-code crewai-alternative langgraph llm meta-agent multi-agent no-code
Last synced: 7 days ago
JSON representation
Host: GitHub
URL: https://github.com/agentlas-ai/hephaestus
Owner: agentlas-ai
License: apache-2.0
Created: 2026-06-04T04:33:26.000Z (17 days ago)
Default Branch: main
Last Pushed: 2026-06-10T23:40:02.000Z (10 days ago)
Last Synced: 2026-06-11T01:21:12.556Z (10 days ago)
Topics: agent-framework, agentic-ai, ai-agent-builder, ai-agents, autogen, claude-code, crewai-alternative, langgraph, llm, meta-agent, multi-agent, no-code
Language: Python
Homepage: https://agentlas.cloud/models/hephaestus
Size: 2.11 MB
Stars: 50
Watchers: 0
Forks: 11
Open Issues: 0
Metadata Files:
- Readme: README.hi.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project

README

          


  

    

  



Hephaestus




  एक अधूरा agent idea लेकर उसे installable Agentlas agent/team repository में बदलें।





  एक specialist agent बनाएं, multi-agent team तैयार करें, या किसी मौजूदा Claude/Codex/OpenClaw/Hermes workspace को public-safe Agentlas package में बदलें।





  English

  ·

  한국어

  ·

  中文

  ·

  日本語

  ·

  हिन्दी





  



---

## पेस्ट करके install (अपने AI से करवाएं)

Terminal नया लगता है? खुद कुछ चलाने की ज़रूरत नहीं। कोई भी AI coding tool —

**Claude Code, Codex, Gemini CLI, Antigravity, या Cursor** — खोलें और नीचे का

message उसके chat box में जैसा है वैसा paste करें। Agent आपके लिए installer

चलाएगा और अगली command बता देगा:

```text

इस workspace में Hephaestus Agentlas meta-agent set up करो। Terminal में

`curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Hephaestus/v0.3.0/scripts/install-all-runtimes.sh | bash`

चलाओ, फिर बताओ कि मैं जो tool इस्तेमाल कर रहा/रही हूँ (Claude Code, Codex,

Gemini CLI, Antigravity, Cursor) उसमें सही /hephaestus command क्या है। कुछ

fail हो तो error पढ़कर ठीक करो और दोबारा try करो।

```

खत्म होने पर अपने tool में `/hephaestus` type करें। खुद commands चलाना चाहते

हैं? नीचे दिया **Quickstart** इस्तेमाल करें।

---

## Quickstart

तीन install paths हैं। अगर आपको पूरा Agentlas runtime चाहिए, तो **1 + 3** इस्तेमाल करें। अगर यह package सीधे Claude Code, Codex या किसी सामान्य project folder में चाहिए, तो **2** इस्तेमाल करें।

| Path | कब इस्तेमाल करें | क्या खोलना है |

|---|---|---|

| 1. Agentlas Terminal | shell से Agentlas agents चलाने के लिए | पहले Agentlas Desktop, फिर macOS Terminal / Windows PowerShell / Linux terminal |

| 2. Standalone Hephaestus | Claude Code, Codex या normal repo में direct install के लिए | Claude Code, Codex या OS terminal |

| 3. Agentlas Desktop | visual local runtime, agent/team management, vault, Apps के लिए | browser में download page, फिर Agentlas Desktop app |

### 1. Agentlas Terminal install करें

Agentlas Terminal **Agentlas Desktop** से install होता है। पहले Desktop install करें, फिर app में यह खोलें:

```text

Agentlas Desktop -> Settings -> Use from the terminal (`agentlas` CLI) -> Install CLI

```

उसके बाद अपना सामान्य terminal खोलें और `agentlas` चलाएं।

**macOS Terminal**

```bash

arch=$([ "$(uname -m)" = "arm64" ] && echo arm64 || echo x64)

curl -fL "https://agentlas.cloud/api/desktop/download?arch=${arch}" -o Agentlas.dmg

open Agentlas.dmg

```

**Windows PowerShell**

```powershell

$r = Invoke-RestMethod https://api.github.com/repos/agentlas-ai/agentlas-desktop/releases/latest

$u = ($r.assets | Where-Object { $_.name -like '*Windows-x64-Setup.exe' }).browser_download_url

Invoke-WebRequest $u -OutFile "$env:TEMP\AgentlasSetup.exe"

Start-Process "$env:TEMP\AgentlasSetup.exe"

```

**Linux terminal, AppImage**

```bash

url=$(curl -fsSL https://api.github.com/repos/agentlas-ai/agentlas-desktop/releases/latest \

  | grep -o 'https://[^"]*Linux-x64\.AppImage' | head -1)

curl -fL "$url" -o Agentlas.AppImage

chmod +x Agentlas.AppImage

./Agentlas.AppImage

```

**Linux terminal, Debian/Ubuntu**

```bash

url=$(curl -fsSL https://api.github.com/repos/agentlas-ai/agentlas-desktop/releases/latest \

  | grep -o 'https://[^"]*Linux-x64\.deb' | head -1)

curl -fL "$url" -o agentlas.deb

sudo dpkg -i agentlas.deb

```

Desktop Settings से CLI install करने के बाद:

```bash

agentlas list

agentlas run agentlas-meta-agent "Package this workflow for Agentlas"

```

### 2. Hephaestus standalone install करें

#### Simple file install

जिस project folder में package files चाहिए, वहां macOS Terminal, Linux terminal, Windows Git Bash या WSL खोलें:

```bash

curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Hephaestus/v0.3.0/scripts/install.sh | bash

scripts/verify-package.sh

scripts/public_safety_check.sh

```

Windows PowerShell:

```powershell

$zip = "$env:TEMP\hephaestus-v0.3.0.zip"

$extract = "$env:TEMP\hephaestus-v0.3.0"

Invoke-WebRequest "https://github.com/agentlas-ai/Hephaestus/archive/refs/tags/v0.3.0.zip" -OutFile $zip

Remove-Item $extract -Recurse -Force -ErrorAction SilentlyContinue

Expand-Archive $zip -DestinationPath $extract -Force

$src = Get-ChildItem $extract -Directory | Select-Object -First 1

Get-ChildItem $src.FullName -Force | Copy-Item -Destination (Get-Location) -Recurse -Force

```

#### Claude Code plugin install

Marketplace registration और plugin installation अलग steps हैं। marketplace command Claude Code को बताता है कि यह repo कहां है। install command असल plugin install करता है। install के बाद reload करें।

**Claude Code chat के अंदर टाइप करें**:

```text

/plugin marketplace add https://github.com/agentlas-ai/Hephaestus --sparse .claude-plugin claude/plugins

/plugin install hephaestus@agentlas-core-engine

/reload-plugins

/plugin list

```

**`claude` CLI वाले OS terminal में टाइप करें**:

```bash

claude plugin marketplace add https://github.com/agentlas-ai/Hephaestus --sparse .claude-plugin claude/plugins

claude plugin install hephaestus@agentlas-core-engine

```

Expected result:

```text

✓ Installed hephaestus. Run /reload-plugins to apply.

Reloaded: 1 plugin · 0 skills · 9 agents · 0 hooks · 0 plugin MCP servers · 0 plugin LSP servers

```

#### Codex plugin install

Codex chat के अंदर `/plugin marketplace add` इस्तेमाल न करें। Codex app में installed plugins देखने के लिए `/plugins` है; install OS terminal से करें।

**`codex` CLI वाले OS terminal में टाइप करें**:

```bash

codex plugin marketplace add agentlas-ai/Hephaestus --ref v0.3.0

codex plugin list

codex plugin add hephaestus@agentlas-core-engine

codex plugin list

```

अगर Codex session पहले से खुला है, तो नया session शुरू करें और `/plugins` से plugin दिख रहा है या नहीं देखें। Install के बाद `/hephaestus ontology` चलाएं।

### 3. Agentlas Desktop install करें

browser में खोलें:

```text

https://agentlas.cloud/desktop

```

Desktop आपको visual Agentlas surface देता है: local projects, agents, teams, Apps, vault references, runtime selection, built-in Core Engine Meta-Agent routing और `agentlas` CLI installer।

## तस्वीरों के साथ install guide

अगर आप Claude Code chat के अंदर हैं, तो Claude slash command वाली तस्वीर follow करें। Codex पहले OS terminal से install करें; Codex app में `/plugins` से installed plugins देखें। अगर आपने macOS Terminal, Windows PowerShell, Linux terminal, Git Bash या WSL खोला है, तो CLI वाली तस्वीरें follow करें।

### Claude Code chat

इन commands को सीधे Claude Code में type करें।

![Claude Code chat install flow](assets/install-claude-code-chat.svg)

### OS terminal में Claude CLI

जब आपके shell में `claude` command उपलब्ध हो, तो यह path इस्तेमाल करें।

![Claude CLI install flow](assets/install-claude-cli.svg)

### Codex app plugin browser

OS terminal में `codex plugin ...` install पूरा करने के बाद Codex app में `/plugins` type करके check करें।

![Codex app plugin browser](assets/install-codex-chat.svg)

### Codex Desktop या IDE Extension

जब Codex में Plugins settings screen दिखे, तो यह path इस्तेमाल करें।

![Codex Desktop settings install flow](assets/install-codex-desktop-settings.svg)

### OS terminal में Codex CLI

जब आपके shell में `codex` command उपलब्ध हो, तो यह path इस्तेमाल करें।

![Codex CLI install flow](assets/install-codex-cli.svg)

## क्या खोलें और कहां type करें

| काम | क्या खोलें | कहां type करें |

|---|---|---|

| Desktop download | Browser | `https://agentlas.cloud/desktop` या OS download command |

| `agentlas` CLI install | Agentlas Desktop | Settings -> Use from the terminal -> Install CLI |

| Agentlas Terminal चलाना | OS terminal | `agentlas list`, `agentlas run ...` |

| Claude plugin slash command से install | Claude Code | `/plugin marketplace add ...`, `/plugin install ...`, `/reload-plugins` |

| Claude plugin shell से install | OS terminal | `claude plugin marketplace add ...`, `claude plugin install ...` |

| Installed Codex plugins देखना | Codex app | `/plugins` |

| Codex plugin shell से install | OS terminal | `codex plugin marketplace add ...`, `codex plugin add ...` |

## यह क्या बनाता है

Hephaestus सिर्फ prompt answer नहीं बनाता। यह ऐसा repository छोड़ता है जिसे दूसरा runtime inspect, install, verify और आगे improve कर सके।

| आप क्या मांगते हैं | Route | Output |

|---|---|---|

| "X करने वाला एक agent बनाओ" | `10-single-agent-builder` | skills, memory contracts, runtime adapters और verification वाला single worker |

| "इस workflow के लिए team/company बनाओ" | `20-multi-agent-team-builder` | HQ, PM Soul, Memory Curator, Policy Gate, eval, QA और handoff वाली multi-agent team |

| "इस existing agent/repo/workspace को package करो" | `30-agentlas-packager` | Desktop import, terminal, Codex, Claude, Gemini या public GitHub release के लिए साफ Agentlas package |

## v0.3.0 में नया

- **CJK search काम करता है।** tokenizer अब Korean/Japanese/Chinese runs के लिए character bigrams बनाता है और FTS index `trigram` tokenizer इस्तेमाल करता है — zero-install CJK corpus search। मौजूदा databases पहली बार खुलने पर अपने आप re-index होते हैं।

- **RRF hybrid ranking।** full-text और vector rankings fixed weights की जगह Reciprocal Rank Fusion से जुड़ती हैं, bounded candidate pool के साथ।

- **Host-LLM search hooks (optional, zero cost)।** Claude Code / Codex जैसे host runtimes query-expansion और rerank hooks inject कर सकते हैं; embedding API की ज़रूरत नहीं, और private/confidential chunks कभी cloud hooks तक नहीं जाते।

- **Ontology-backed agent mode।** builders retrieval-first, citation-attached agents बनाते हैं (`modes/ontology-backed-agent.md`, reference: `examples/ontology-proposal-agent/`); contracts rule-based inject होते हैं और `loop_policy` task risk से तय होता है।

- **Adapter drift gate + MCP surface check।** `scripts/sync-adapters.sh --check` और `scripts/verify-mcp-surface.sh` जोड़े गए।

## Architecture

public core architecture/foldering contract है। Claude, Codex, Gemini, Desktop और Terminal folders उसी core पर बने thin adapters हैं; वे अलग source of truth नहीं हैं।

| Public contract | काम |

|---|---|

| Mode auto-detection | generation से पहले `single-agent-creator`, `team-builder`, या `agentlas-packager` चुनता है |

| Clarify question loop | सिर्फ runtime, public/private boundary, tools या safety पर असर डालने वाले सवाल पूछता है |

| `.agentlas` auto-activation | local runtime को project memory, sitemap/task-bias, Memory Tickets और vault references seed करने देता है |

| Skill lifecycle registry | skill को candidate metadata से शुरू करता है और trial/Curator decision ledgers रखता है |

Default export conservative है। Generated skills automatic first-class recall नहीं बनते। Curator को execution evidence, sealed holdout/replay, rollback coverage और workspace policy approval देखना होगा।

## Agentlas Desktop और Terminal साथ क्यों बेहतर हैं

- Desktop agent/team structure, local projects, Apps, vault references और runtime choices दिखाता है।

- Terminal वही package `agentlas` command से चलाता है।

- Desktop/Terminal में Core Engine Meta-Agent path built in है, इसलिए fresh install के बाद भी agent creation और packaging शुरू हो सकती है।

- Standalone Claude/Codex install तब उपयोगी है जब package सीधे उन runtimes में चाहिए।

## Compare

| तुलना | उनकी ताकत | Hephaestus क्या जोड़ता है |

|---|---|---|

| OpenAI / Codex | strong models और coding terminal | portable repo contracts, `.agentlas` memory/package files, skills, schemas, runtime adapters, public verification |

| Claude / Claude Code | strong reasoning और Claude-native workflows | Claude support, लेकिन Claude-only नहीं; Codex, Gemini, Desktop, terminal और `AGENTS.md` भी aligned रहते हैं |

| OpenClaw | local identity और workspace agent loop | visible role folders, Agentlas package contracts, public-safety checks, Desktop import, vault references |

| Hermes | persona और memory-centered local runtime | PM Soul, Memory Tickets, sitemap/task-bias, policy/eval/QA, skill lifecycle evidence |

OpenAI और Claude model/runtime surfaces हैं। OpenClaw और Hermes local-agent experiences हैं। Hephaestus agent को portable, inspectable, installable और publishable बनाने वाली package layer है।

## Usage examples

```text

/meta-agent Create a research agent for SEC filing analysis.

Package it for Codex, Claude Code, Gemini, and Agentlas Desktop.

```

```text

Use Hephaestus.

Build a customer-support operations team with PM Soul, Memory Curator, Policy Gate, QA, eval, and public-safe release checks.

```

```text

Package this local OpenClaw/Hermes-style workspace into Agentlas architecture.

Keep private notes, machine paths, raw logs, and secrets out of the public repo.

```

## Docs

| Goal | Document |

|---|---|

| canonical route समझना | [`AGENTS.md`](AGENTS.md) |

| team contract देखना | [`agent.md`](agent.md) |

| source of truth देखना | [`docs/source-of-truth.md`](docs/source-of-truth.md) |

| runtime boundaries समझना | [`docs/runtime-sync-boundaries.md`](docs/runtime-sync-boundaries.md) |

| mode चुनना | [`docs/mode-classifier.md`](docs/mode-classifier.md) |

| package verify करना | [`scripts/verify-package.sh`](scripts/verify-package.sh) |

| public safety check करना | [`scripts/public_safety_check.sh`](scripts/public_safety_check.sh) |

## Public Safety Boundary

यह repo hosted Agentlas billing/account logic, production credentials, customer data, raw private logs, raw transcripts, desktop keychain storage, local database implementation या private deployment configuration शामिल नहीं करता।

Public package में local machine paths, API keys, tokens, private keys, service-account JSON, `.env` secrets, private research notes, raw chat transcripts, customer logs, hosted billing/account/OAuth internals या desktop storage internals नहीं होने चाहिए।

## License

Apache-2.0. [`LICENSE`](LICENSE) देखें।
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/agentlas-ai/hephaestus

Awesome Lists containing this project

README

Hephaestus
