AAPP‑MART (Autonomous Agent & Predictive Processing Framework) is a modular AI-driven framework designed for autonomous agents, predictive task processing, and scalable tool integration.
This documentation provides a complete overview of the framework’s architecture, components, usage patterns, and installation guidance.
Modern infrastructures are too complex for traditional security testing.
AAPP‑MART combines predictive AI with autonomous agent-based simulation to continuously evaluate an environment’s attack surface.
It consists of two major components:
Together, they create a fully automated offensive security engine capable of forecasting attacks end-to-end.
AAPP‑MART is a cross-platform Python project and runs on:
No platform-specific dependencies are required.
AAPP‑MART is built on a modular architecture with the following layers:
⚠️ Note: AAPP‑MART is currently under active development.
Installation instructions will be provided after the first stable release.
For development setup, you can clone the repository and create a Python virtual environment:
git clone https://github.com/secwexen/aappmart
cd aappmart
# Create a virtual environment
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install -r requirements.txt
The documentation is organized as follows:
AAPP‑MART consists of three primary layers:
Agent Layer Autonomous units responsible for executing tasks and interacting with modules.
Predictive Processing Layer Models and logic that support decision-making and task prioritization.
Modular Tool Layer System, network, memory, and automation tools used by agents.
All layers are coordinated by the Orchestrator and connected via the Pipeline system.
Example usage scenarios are provided in the examples/ directory:
examples/basic_usage.pyexamples/custom_agent_example.pyexamples/pipeline_example.pyPython usage example:
from aappmart.core.orchestrator import AAPP_MART
engine = AAPP_MART(target="192.168.1.10")
engine.run()
report = engine.get_report()
print(report)
⚠️ Core implementation is still in progress. Some modules may not be fully functional yet.
This project is licensed under Apache License 2.0.
For full details, see the LICENSE file in the repository root.
Contributions are welcome.
Please open an issue before submitting major changes or new features.
Refer to CONTRIBUTING.md for detailed guidelines.
Planned features include:
AAPP‑MART is designed for authorized security testing only.
Use against systems without explicit permission is illegal.
All users must comply with applicable laws and organizational policies.
The AAPP‑MART documentation is continuously updated.
New modules, agents, and predictive components will be added as development progresses.