redcell

AI एजेंट जो एक पेनिट्रेशन टेस्ट को शुरू से अंत तक चलाते हैं और रिपोर्ट लिखते हैं।

[!WARNING] REDCELL केवल शिक्षा, अनुसंधान, और कानूनी, अधिकृत सुरक्षा परीक्षण के लिए प्रदान किया गया है। इसका उपयोग केवल उन सिस्टमों का परीक्षण करने के लिए करें जिनके आप स्वामी हैं या जिनका परीक्षण करने के लिए आपके पास स्पष्ट लिखित अनुमति है, और केवल सहमत दायरे के भीतर। कंप्यूटर सिस्टमों तक अनधिकृत पहुँच या उनमें हस्तक्षेप अज़रबैजान (आपराधिक संहिता के अनुच्छेद 271 से 273) और अधिकांश अन्य देशों के कानूनों के तहत अपराध है। इसका उपयोग आप कैसे करते हैं, और कानून के भीतर रहना, पूरी तरह से आपकी ज़िम्मेदारी है।

---

यह क्या है

REDCELL LLM एजेंटों की एक टीम को एक पेनटेस्ट के माध्यम से चलाता है। एक ऑर्केस्ट्रेटर एंगेजमेंट की योजना बनाता है और उद्देश्यों को executor एजेंटों को सौंपता है, जो एक Kali कंटेनर के भीतर वास्तविक टूल चलाते हैं और वापस रिपोर्ट करते हैं। आप एक ऑपरेटर कंसोल से रन को देखते और नियंत्रित करते हैं: एक चैट जो ऑर्केस्ट्रेटर को चलाती है, एक लाइव एजेंट ग्राफ़ और गतिविधि फ़ीड, एजेंट द्वारा संचालित ब्राउज़र का लाइव दृश्य, एजेंट द्वारा पकड़े गए किसी भी reverse shell पर एक टर्मिनल, और काम पूरा होने पर सौंपने के लिए एक रिपोर्ट।

मॉडल LiteLLM के माध्यम से pluggable हैं, इसलिए आप इसे OpenAI, Anthropic, Google, GLM, DeepSeek, Kimi, एक स्थानीय Ollama, या जो कुछ भी यह समर्थन करता है, पर इंगित कर सकते हैं। प्रत्येक रन जैसे-जैसे आगे बढ़ता है checkpoint करता है, इसलिए क्रैश या रीस्टार्ट वहीं से शुरू होता है जहाँ यह छूटा था।

विशेषताएँ

• मल्टी-एजेंट इंजन। एक LangGraph plan/act लूप। ऑर्केस्ट्रेटर उद्देश्यों को executor एजेंटों को सौंपता है जो शेल टूल चलाते हैं और काम करते समय findings, loot, और hosts रिकॉर्ड करते हैं।
• संरचित टूल। nmap, nuclei, directory और vhost discovery, और Metasploit search और run के लिए समर्पित टूल। प्रत्येक अपने आउटपुट को attack surface या findings में पार्स करता है, इसलिए एक स्कैन बिना किसी अनुवर्ती चरण के hosts और vulnerabilities रिकॉर्ड करता है। run_command किसी भी ऐसी चीज़ को कवर करता है जिसके लिए समर्पित टूल नहीं है।
• वास्तविक निष्पादन, स्थानीय या दूरस्थ। टूल docker exec के माध्यम से एक Kali कंटेनर में चलते हैं। प्रति सत्र localhost या एक सहेजा गया सर्वर चुनें; एक दूरस्थ सर्वर host networking के साथ SSH के माध्यम से वही कंटेनर चलाता है।
• एजेंट ब्राउज़र। लॉगिन फ़्लो और JavaScript-भारी ऐप्स के लिए जिन तक शेल टूल नहीं पहुँच सकते, एक एजेंट Kali कंटेनर में एक वास्तविक Chromium चलाता है। आप इसे लाइव देखते हैं और स्वयं कुछ क्लिक करने के लिए नियंत्रण ले सकते हैं, फिर इसे वापस सौंप सकते हैं।
• Reverse shells। एक एजेंट एक listener खोलता है, shell पकड़ता है, और आपको उस पर एक इंटरैक्टिव टर्मिनल देता है। आप अपने स्वयं के टर्मिनल भी खोल सकते हैं और स्वयं कमांड चला सकते हैं।
• नेटवर्क pivoting। टूल ट्रैफ़िक को पकड़े गए reverse shell के माध्यम से रूट करें ताकि उन hosts तक पहुँचा जा सके जो केवल समझौता किए गए मशीन से दिखाई देते हैं। एक chisel reverse SOCKS tunnel इसे ले जाता है, और nmap स्वचालित रूप से tunnel के माध्यम से चलता है।
• चैट रन को चलाती है। चैट को बताएं कि आप क्या चाहते हैं और यह लाइव ऑर्केस्ट्रेटर को नियंत्रित करती है, या नया काम करने के लिए एक समाप्त रन को फिर से खोलती है। यह एंगेजमेंट के बारे में प्रश्नों का उत्तर भी देती है।
• कोड-स्कैन सत्र। स्रोत-कोड सुरक्षा समीक्षा के लिए एक सत्र को एक सार्वजनिक git repo या एक स्थानीय फ़ोल्डर पर इंगित करें, findings को फ़ाइल और पंक्ति पर वापस मैप किया जाता है।
• प्रति-सत्र कॉन्फ़िग। प्रति सत्र execution server, मॉडल, और एक वैकल्पिक egress proxy सेट करें। सर्वर और proxies एक वास्तविक कनेक्शन परीक्षण के साथ आते हैं ताकि आप उन पर भरोसा करने से पहले जान सकें कि वे काम करते हैं।
• Findings triage। Findings को सत्यापित या खारिज करें और उन डुप्लिकेट को मर्ज करें जिन्हें एजेंट ने दो बार रिकॉर्ड किया। रिपोर्ट खारिज किए गए लोगों को छोड़ देती है और सत्यापित लोगों को चिह्नित करती है।
• रिपोर्ट। एक PDF प्लस JSON और SARIF निर्यात करें। लेखन सत्र के मॉडल द्वारा उत्पन्न किया जाता है और इसे साफ़ किया जाता है ताकि यह ऐसा पढ़ा जाए जैसे किसी व्यक्ति ने लिखा हो, जिसमें एक executive summary, methodology, findings, और प्राथमिकता क्रम में remediation हो।
• लाइव कंसोल। गतिविधि फ़ीड, टर्मिनल, और एजेंट का ब्राउज़र WebSockets पर स्ट्रीम होते हैं; एजेंट ग्राफ़, findings, loot, attack surface, listeners, और proxy history एक छोटे poll पर रीफ़्रेश होते हैं। रन के काम करते ही यह सब लाइव अपडेट होता है।
• सूचनाएँ। इन-ऐप toasts, साथ ही ब्राउज़र सूचनाएँ जब टैब पृष्ठभूमि में हो ताकि एजेंट का कोई प्रश्न या पकड़ा गया shell अनदेखा न रहे।

आर्किटेक्चर

flowchart LR
  UI["Operator console<br/>React + Vite"] -->|REST + WebSocket| API["FastAPI"]
  API --> PG[(PostgreSQL)]
  API --> RS[(Redis<br/>pub/sub + queue)]
  API --> S3[(MinIO<br/>files & reports)]
  RS --> W["Worker (arq)"]
  W --> ENG["Engine<br/>LangGraph + LiteLLM"]
  ENG -->|docker exec| KALI["Kali container<br/>local or remote over SSH"]
  KALI --> TGT["Targets"]
  W -->|events / chat / shell| RS
  RS -->|stream| API

API एजेंट नहीं चलाता। यह एक रन को कतार में डालता है, worker इसे निष्पादित करता है, और worker आउटपुट को Redis चैनलों पर प्रकाशित करता है जिन्हें API WebSockets के माध्यम से ब्राउज़र तक रिले करता है।

स्टैक

Python 3.12, FastAPI, async SQLAlchemy + asyncpg, Alembic, arq, LangGraph, LiteLLM, ReportLab, PostgreSQL, Redis, MinIO, asyncssh। फ्रंटएंड: React 18, Vite, TypeScript, Tailwind, TanStack Query, xterm। टूलिंग: Python के लिए uv, फ्रंटएंड के लिए bun।

क्विकस्टार्ट

आपको Docker, uv, और bun की आवश्यकता होगी।

# 1. infrastructure (Postgres, Redis, MinIO)
docker compose -f docker-compose.dev.yml up -d

# 2. Python deps, database, and seed data
uv sync --group live
uv run rc db upgrade
uv run rc seed              # admin user, provider catalog, buckets

# 3. copy the env template
cp .env.example .env

# 4. run the three processes (separate terminals)
cd apps/api    && uv run uvicorn app.main:app --host 127.0.0.1 --port 8080
cd apps/worker && uv run arq worker.settings.WorkerSettings
cd apps/web    && bun install && bun run dev

या एक प्रोसेस मैनेजर के साथ तीनों को एक साथ शुरू करें (वे Procfile में घोषित हैं): pipx install honcho फिर honcho start।

http://localhost:5183 खोलें और admin / admin से साइन इन करें।

रन डिफ़ॉल्ट रूप से वास्तविक टूल निष्पादित करते हैं। Settings में एक provider API key जोड़ें और सुनिश्चित करें कि Docker Kali image (ghcr.io/martian56/redcell-kali:latest) खींच सकता है। इसके बजाय canned output के विरुद्ध dry-run करने के लिए, .env में REDCELL_RUN_MODE=sim सेट करें।

अभ्यास लक्ष्य

REDCELL को निशाना बनाने के लिए जानबूझकर असुरक्षित ऐप्स, सभी स्थानीय: