explaingit

yangdada863/aimy-sikll

16CSSAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A Python command-line toolkit for authorized security testing that bundles port scanning, directory enumeration, and SQL injection detection into one tool, outputting JSON results ready to feed into AI agent frameworks like AutoGPT or LangChain.

Mindmap

mindmap
  root((repo))
    What It Does
      Port scanning
      Directory enumeration
      SQL injection detection
    Output
      Structured JSON
      Agent-ready results
    Tech Stack
      Python 3.8+
      Command-line interface
    Use Cases
      Authorized pentesting
      AI agent pipelines
      Automated recon
    Audience
      Security researchers
      CTF players
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Run port scans on a target host to discover which services are exposed and feed the JSON results into an AI agent for further analysis.

USE CASE 2

Enumerate directories on a web application to find hidden pages or admin panels during an authorized penetration test.

USE CASE 3

Test a URL parameter for SQL injection vulnerabilities and get structured JSON output for automated reporting.

USE CASE 4

Chain all three tools inside an AutoGPT or LangChain agent to run a basic penetration test automatically.

Tech stack

Python

Getting it running

Difficulty · easy Time to first run · 5min

Single git clone and pip install, requires Python 3.8 or newer and explicit permission to test any target system.

Use freely for any purpose including commercial use, as long as you keep the copyright notice.

In plain English

aimy-sikll is a lightweight Python toolkit for security testing, designed for use in authorized environments, CTF competitions, and vulnerability research. It packages three common reconnaissance and testing tasks into a single command-line tool that outputs structured JSON results, making it easy to integrate into automated workflows or AI agent pipelines. The three capabilities are port scanning, directory enumeration, and SQL injection detection. Port scanning probes a target host to find which common network ports are open, such as those used by web servers, databases, or remote access services. Directory enumeration takes a website URL and a wordlist of common path names, then tries each one to see which pages or directories actually exist and what status code they return. SQL injection detection tests a specific URL parameter by submitting a set of known attack patterns and watching for database error messages or slow responses that indicate the target may be vulnerable. All three tools output JSON, which makes their results easy to pass to another program or to an AI agent for further analysis. The README describes it as designed to plug into agent frameworks like AutoGPT or LangChain so an AI assistant can plan and run basic penetration testing steps automatically. Installation is a single git clone followed by a pip install. Each tool can be run independently or through the main entry point with subcommands. The project is written in Python and requires version 3.8 or newer. The README includes a legal notice: the tool is only for use in environments where explicit permission has been granted. Unauthorized use against systems you do not own or have permission to test may violate laws. The license is MIT.

Copy-paste prompts

Prompt 1
I have aimy-sikll installed. Write a Python script that runs the port scanner on 192.168.1.1 and passes the JSON output to a LangChain agent for analysis.
Prompt 2
Using aimy-sikll's directory enumeration tool, how do I supply a custom wordlist and filter results to only show 200 and 301 status codes?
Prompt 3
I want to run aimy-sikll's SQL injection detector on a login form parameter. What command do I use and what output should I expect?
Prompt 4
Help me integrate aimy-sikll into an AutoGPT plugin so the agent can run all three tools in sequence and report findings as structured JSON.
Open on GitHub → Explain another repo

← yangdada863 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.