Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
antoninoLorenzo committed Jul 21, 2024
2 parents 32ae70f + af92fbb commit d00ac7e
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 6 deletions.
6 changes: 3 additions & 3 deletions CONTRIBUTE.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,8 @@ and maintain realistic expectations.
## Design Goals

Our main design goals for this project are:
- **Cost-Free Solution**: Penetration testing tools are free (most of them), so there’s no reason to pay for inference APIs or LLM-as-a-service. This is a challenge, but we hope you find it motivating rather than limiting.
- **Flexibility**: Penetration testers have their own preferences and workflows, so flexibility is key to delivering a quality tool.
- **Cost-Free Solution**: Penetration testing tools are free (most of them), so **there’s no reason to pay for inference** APIs or LLM-as-a-service. This is a challenge, but we hope you find it motivating rather than limiting.
- **Flexibility**: Penetration testers have their own preferences and workflows, so flexibility is key to deliver a quality tool.
- **Human In the Loop**: This solution is not meant to automate the entire penetration testing process. It’s designed to provide another perspective on a problem, acting on your instructions, but AI will never replace experience.

# How to Contribute
Expand Down Expand Up @@ -100,7 +100,7 @@ You can contribute in various ways:

## Testing

### LLM Integration
<h3 id="llm-integration">LLM Integration</h2>

- When integrating new LLM models, ensure they meet the existing acceptance tests ([planning](./test/test_acceptance/test_planning.py) and [conversion](./test/test_acceptance/test_conversion.py)). Validate that the new model performs as expected within the AI-OPS framework.
<!-- TODO: test_acceptance.md -->
Expand Down
16 changes: 13 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

### Table of Contents
1. [Overview](#-overview)
2. [Key Features](#key-features)
- [Key Features](#key-features)
3. [Installation](#-install)
- [End-User](#end-user)
- [Development](#development)
Expand All @@ -24,7 +24,7 @@

**AI-OPS** is an AI-powered, Open-source Penetration testing Suite that leverages Large Language Models (LLMs) AI-Agent to assist and automate tasks such as reconnaissance, exploitation, and report generation.

> **Note:** AI-OPS is designed to enhance, not replace, human penetration testers, similar to how AI enhances great programmers by making them more productive.
> **Note:** AI-OPS is designed to enhance, not replace, human penetration testers.
## Key Features

Expand All @@ -33,7 +33,16 @@
- 📚 **Up-to-date Knowledge**: Use the `RAG` system to keep the agent informed with the latest documents and data.
- ⚙️ **Scalability**: Independently deployable components allow you to utilize any hardware setup.

## 💻 Install
<!--
## Current Status
A manual testing process is being done.
Issues:
- Can't use `openvpn` in Docker container to interact with TryHackMe machines.
- In `ai-ops-cli` multiline strings can't be pasted.
-->
# 💻 Install
**Requirements**
- Ollama (see [Ollama](https://github.com/ollama/ollama))
- Docker (see [Docker Desktop](https://docs.docker.com/desktop/)) (*in development*)
Expand Down Expand Up @@ -106,6 +115,7 @@ Once the CLI is running, you can interact with the agent using the following com
- `load` : Load a saved session.```

### Supported Models
To integrate a LLM see [LLM Integration](./CONTRIBUTE.md#llm-integration) in CONTRIBUTE.md
| Name | Implemented (prompts) |
|--------------|----------------------|
| **Gemma 7B** | &check; |
Expand Down

0 comments on commit d00ac7e

Please sign in to comment.