Quick start (automatically handles configuration and startup)

<!-- Logo image placeholder - add docs/assets/logo.png when available -->
<!-- <p align="center">
  <img src="docs/assets/logo.png" alt="JoySafeter" width="120" />
</p> -->

<h1 align="center">JoySafeter</h1>

<p align="center">
  <strong>Build Production-Grade AI Security Agents in 3 Minutes</strong>
</p>

<p align="center">
  Enterprise-grade intelligent agent orchestration platform with SOTA security capabilities
</p>

<p align="center">
  <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0"></a>
  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.12+-3776AB?logo=python&logoColor=white" alt="Python 3.12+"></a>
  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-20+-339933?logo=nodedotjs&logoColor=white" alt="Node.js 20+"></a>
  <a href="https://github.com/langchain-ai/langgraph"><img src="https://img.shields.io/badge/LangGraph-1.0+-FF6F00?logo=chainlink&logoColor=white" alt="LangGraph"></a>
  <a href="https://fastapi.tiangolo.com/"><img src="https://img.shields.io/badge/FastAPI-0.122+-009688?logo=fastapi&logoColor=white" alt="FastAPI"></a>
  <a href="#"><img src="https://img.shields.io/badge/MCP-Protocol-purple" alt="MCP Protocol"></a>
</p>

<p align="center">
  English | <a href="./README_CN.md">简体中文</a>
</p>

<p align="center">
  <a href="#features">Features</a> •
  <a href="#quick-start">Quick Start</a> •
  <a href="#roadmap">Roadmap</a> •
  <a href="#documentation">Documentation</a> •
  <a href="#contributing">Contributing</a>
</p>

<!-- Screenshot placeholder - add docs/assets/screenshot-builder.png when available -->
<!-- <p align="center">
  <img src="docs/assets/screenshot-builder.png" alt="Agent Builder Screenshot" width="800" />
</p> -->

## Table of Contents

- [Why JoySafeter?](#why-joysafeter)
- [Features](#features)
- [Architecture](#architecture)
- [Recent Change Log](#recent-change-log)
- [Tech Stack](#tech-stack)
- [Quick Start](#quick-start)
- [Roadmap](#roadmap)
- [Comparison](#comparison)
- [Documentation](#documentation)
- [Contributing](#contributing)
- [License](#license)
- [Acknowledgments](#acknowledgments)

---

## Why JoySafeter?

> **JoySafeter is not just a productivity tool, but an "operating system" for security capabilities.**
> It unifies fragmented security tools into a collaborative AI army through visual intelligent orchestration, and precipitates individual expert experience into organizational digital assets. It is the first to define a new paradigm of **AI-driven Security Operations (AISecOps)** in the industry.

<table>
<tr>
<td width="50%">

### For Enterprise Security Teams

- **Visual Development** — No-code agent builder for rapid prototyping
- **200+ Security Tools** — Pre-integrated Nmap, Nuclei, Trivy, and more
- **Governance & Audit** — Full execution tracing and observability
- **Multi-tenancy** — Isolated workspaces with role-based access

</td>
<td width="50%">

### For AI Security Researchers

- **Graph-based Workflows** — Complex control flows with loops, conditionals, and parallel execution
- **Memory Evolution** — Long/short-term memory for continuous learning
- **MCP Protocol** — Model Context Protocol for unlimited tool extensibility
- **DeepAgents Mode** — Multi-level hierarchical agent orchestration

</td>
</tr>
</table>

---

## Dual-Mode Architecture: Rapid & Deep

JoySafeter offers two distinct modes to meet diverse operational needs:

<table>
<tr>
<td width="50%">

### ⚡ Rapid Mode

**Value Proposition**: Describe requirements → Auto-orchestrate Skills → Auto-team formation → Minute-level deployment

**Key Benefits**:
- 🚀 **Zero-Barrier Entry**: Natural language requirements, AI automatically understands and orchestrates
- 🎯 **Intelligent Matching**: Platform auto-matches optimal Skills combinations, builds professional Agent teams
- ⏱️ **Minute-Level Deployment**: From requirements to runnable Agent in 3-5 minutes
- 🔄 **Out-of-the-Box**: Built-in 10+ core security scenario templates, one-click activation

**Use Cases**:
- Rapid security assessment and vulnerability scanning
- Standardized security detection workflows
- Quick onboarding for beginners
- Emergency security incident response

</td>
<td width="50%">

### 🎨 Deep Mode

**Value Proposition**: Visual orchestration → Debugging → Observability → Continuous iteration for professional team collaboration

**Key Benefits**:
- 🏗️ **Visual Orchestration**: Drag-and-drop complex workflows, 11 node types, supports loops, conditions, parallel execution
- 🔍 **Full-Stack Debugging**: Real-time execution tracing, state visualization, breakpoint debugging, precise problem localization
- 📊 **Enterprise Observability**: Langfuse integration, complete execution trace tracking and performance analytics
- 🔄 **Continuous Evolution**: Version control, A/B testing, memory evolution, Agents get smarter over time

**Use Cases**:
- Comple

... (truncated)