Biubo

KO | EN

gitlite — search

#javascript #python #php #java #ruby #css #hacktoberfest #r #angularjs #go #opengl #python3

★ 62 Open GitHub ↗

🛡️ A modern, AI-powered WAF with visual forensic playback via rrweb. Protect your web apps with LLM-driven threat detection, real-time visualization, and zero-config deployment.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🛡️ Biubo WAF

<img src="assets/biubo_waf_banner.svg" alt="Biubo WAF Banner" width="800px">
 
 <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
 <img src="https://img.shields.io/badge/python-3.8%2B-blue.svg" alt="Python">
 <img src="https://img.shields.io/badge/Release-v1.0.0--alpha-orange.svg" alt="Release">
 <img src="https://img.shields.io/badge/AI-LLM_Integrated-purple.svg" alt="AI">
 <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
 
 A Web Application Firewall that Thinks, Remembers, and Visualizes.

---

## ⚡ What is Biubo WAF?

**Biubo WAF** is not just another rule-based filter. It is an **Intelligence-First Proxy** that bridges the gap between high-speed security and modern AI intuition. It sits as a guardian in front of your applications, watching every request through a dual lens of **Regex Performance** and **LLM Awareness**.

> [!TIP]
> **Zero-Zero Setup**: No SQL, No Redis, No complex Nginx configs. Just Python and the power of AI.

---

## 🎬 See it in Action

### 1. 🧠 Intelligence You Can Trust
Biubo WAF monitors every packet. From complex obfuscated payloads to sudden anomalies, watch it neutralize threats in milliseconds before they even reach your server.
> **![AI Detection Demo](https://raw.githubusercontent.com/BiuboWAF/Biubo/main/assets/GIF_01_AI_DETECTION.gif)**
> *Attack detected and IP instantly isolated using high-speed signature and semantic correlation.*

### 2. 🎥 Visual Forensics (The "DVR" for Security)
Stop guessing. Watch exactly what the attacker did on your site with our integrated `rrweb` session playback.
> **![Visual Replay Demo](https://raw.githubusercontent.com/BiuboWAF/Biubo/main/assets/GIF_02_RRWEB_REPLAY.gif)**

### 🗺️ 3. Real-time Attack Visualization
Stay ahead of the threat. Visualize every incoming attack on a live global map, providing instant situational awareness.
> **![Global Attack Map](https://raw.githubusercontent.com/BiuboWAF/Biubo/main/assets/GIF_03_ATTACK_MAP.gif)**

---

## ✨ Key Features

---

## 🧱 Architecture & Flow

```mermaid
graph LR
    A[Client Traffic] --> B[Biubo Gateway]
    subgraph Engine
        B --> C{Regex Match?}
        C -- No --> D{LLM Opinion?}
        D -- Hacker --> E[BLOCK]
        C -- Yes --> E
        D -- Normal --> F[PASS]
    end
    F --> G[Your Backend]
    E --> H[Visual Log + rrweb]
```

---

## 🚀 Quick Start

### One-Step Installation
```bash
# Clone the repository
git clone https://github.com/BiuboWAF/Biubo.git
cd Biubo

# Run the interactive setup
python setup.py

# Start protecting
python main.py
```

### Docker Deployment
```bash
docker run zplb/biubo:1.1.0
```

---

## 📑 Documentation Links

-   [**Developer Guide**](DEVELOPER.md) - How the engine works internally.
-   [**Roadmap**](ROADMAP.md) - Our vision for P1/P2/P3.
-   [**Contributing**](CONTRIBUTING.md) - We need your code and ideas!

---

## 📄 License

Biubo WAF is open-source software licensed under the **MIT License**.

Built with ❤️ for a more secure, intelligent web.

Biubo

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README