git404hub

what is drowai fr?

quareth/drowai — explained in plain English

Analysis updated 2026-05-18

6PythonAudience · developerComplexity · 5/5Setup · hard

tl;dr

DrowAI is a work-in-progress platform that runs AI agents to perform isolated security testing tasks inside Docker and Kali Linux containers.

vibe map

mindmap
  root((DrowAI))
    What it does
      AI red team agent
      Isolated task runtimes
      Web control plane
    Tech stack
      FastAPI backend
      React frontend
      LangGraph agent
      Docker and Kali
    Use cases
      Red team workflows
      Agent orchestration
      Vibe coding case study
    Audience
      Security engineers
      Developers
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run AI-assisted red team security workflows inside isolated Docker or Kali containers.

VIBE 2

Experiment with LangGraph-based agent orchestration for security tasks.

VIBE 3

Study how a large AI-assisted, vibe-coded application was architected.

what's the stack?

PythonFastAPIReactTypeScriptLangGraphDockerPostgreSQLKali Linux

how it stacks up fr

quareth/drowaiaclark4life/home-depot-crawlashishdevasia/ha-proton-drive-backup
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity5/52/52/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires PostgreSQL with the pgvector extension plus Docker for the Kali execution runtime.

in plain english

DrowAI is a work-in-progress platform for running AI agents that perform security testing tasks in isolated environments. Each task gets its own Docker or Kali Linux runtime, so an agent's actions stay contained and separate from other work. The project is public but still pre-v1: setup, deployment packaging, APIs, and documentation are expected to keep changing while the architecture settles. The system is built around three parts. A backend control plane, written with FastAPI, handles login, tenants, tasks, chat, settings, reporting, and real-time updates over WebSocket and server-sent events. A React and TypeScript frontend lets a person operate tasks, watch live streams, review artifacts and terminals, and read reports. An agent runtime, built on LangGraph, plans and runs the actual work, choosing from a registry of tools. Not every implemented tool is shown to the AI model, only tools that meet a certain quality bar for parsing, result formatting, and evidence tracking are exposed for the model to pick from on its own. Task execution happens through a runtime provider layer that can use either a local Docker setup or a separate managed runner process, which itself starts per-task Kali Linux containers through the host's Docker socket. The Kali runtime images used for these tasks are published on Docker Hub, and their build files are included in the repository. The project was built almost entirely through AI-assisted coding, led by a cybersecurity engineer with a decade of professional experience but no formal background in software development. The author has written publicly about the experience of building a large application this way. To run it locally, you need Python 3.11 or newer, Node.js 20.19 or newer, PostgreSQL 15 or newer with the pgvector extension, and Docker. A setup script installs dependencies, checks for the right database and extension, and offers to create them if missing. Once running, the frontend is available on localhost, and the backend exposes an API with documentation. This is meant for developers and researchers exploring red team automation, not for people without technical setup experience.

prompts (copy fr)

prompt 1
Help me set up DrowAI locally with Python 3.11, PostgreSQL and pgvector.
prompt 2
Explain how DrowAI's runtime provider layer chooses between local Docker and a managed runner.
prompt 3
Walk me through DrowAI's three-plane architecture: management, data, and execution.
prompt 4
Show me how to add a new tool to DrowAI's LLM-visible toolset.

Frequently asked questions

what is drowai fr?

DrowAI is a work-in-progress platform that runs AI agents to perform isolated security testing tasks inside Docker and Kali Linux containers.

What language is drowai written in?

Mainly Python. The stack also includes Python, FastAPI, React.

How hard is drowai to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is drowai for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.