Skip to content

Kaademos/kademos

Kademos Logo

The Context-Aware Security Requirements Engine for Devs and Agentic AI

PyPI - Version Python Version License


Kademos Demo

Security compliance shouldn't rely on guesswork, and AI agents shouldn't write code without guardrails.

Kademos is a modern DevSecOps engine that bridges the gap between the OWASP ASVS 5.0 standard and actionable developer workflows. It analyzes your codebase, understands your application's capabilities, and generates exact, machine-readable security requirements.

Quick Start · For AI Agents · Documentation · Report Bug


✨ Why Kademos?

The era of static, Excel-based security checklists is over. Whether you are a developer building a new feature or an Agentic AI (like Devin or Claude) writing code autonomously, you need exact security requirements before the code is written.

  • 🧠 Context-Aware Scanning: Kademos parses your AST and package managers (React, Django, PostgreSQL) to detect features and map them automatically to ASVS Level 1 & 2 requirements.
  • 🤖 Native Agentic AI Support: Export tightly structured XML context blocks designed specifically for LLM context windows.
  • 💬 Beautiful Interactive TUI: Use kademos interact to walk through a guided, rich terminal interface when planning new features.
  • 🛡️ Threat Model Ready: Generates perfectly scoped STRIDE prompts based on your tech stack to kickstart LLM-assisted threat modeling.

🚀 Quick Start

Installation

pip install kademos

1. Scan your Repository

Let Kademos figure out what your app does and generate the security baseline:

kademos scan ./my-project --level 2 --format markdown > SECURITY_REQUIREMENTS.md

2. Interactive Feature Planning (TUI)

Planning a new password reset flow? Generate the exact ASVS requirements interactively:

kademos interact

🤖 Agentic AI Integration

Kademos is built to be the "Security Brain" for AI coding agents. If you are using Claude, Devin, or a custom GPT, inject Kademos into your pipeline.

Use the --ai-context flag to output pure, structured XML that LLMs understand perfectly:

kademos scan ./backend --ai-context > ai_security_guardrails.xml

Example Agent Prompt:

"Read ai_security_guardrails.xml. You are tasked with writing the new File Upload module. Ensure your generated code strictly adheres to the ASVS V5 requirements outlined in the context block."


🛠️ CLI Reference

Simply type kademos to see the splash screen and available commands.

Command Description
kademos scan Analyze repo AST/packages to map context to ASVS requirements
kademos interact Generate requirements via AI-guided developer TUI
kademos threatmodel Generate scoped LLM prompts for STRIDE modeling
kademos export Push actionable requirements to Jira, Azure, or Asana
kademos resources Manage ASVS reference files and local cache

🤝 Contributing

We welcome contributions from the community! Check out our Contributing Guide to see how you can add framework adapters, improve the TUI, or expand AI prompt generation.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

OWASP ASVSReport BugRequest Feature