asaa


Nameasaa JSON
Version 0.1.2 PyPI version JSON
download
home_pageNone
SummaryThe Application Security Assessment Assistant
upload_time2024-04-26 17:46:16
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseMIT License
keywords security ai assistant
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # asaa

The Application Security Assessment Assistant.

## Description

`asaa` helps you evaluate the security posture of your application by chatting with an AI assistant and answering a series of questions. At the end of the assessment `asaa` will give you a score and possibly some recommendations for improving your app's security posture.

At the core of `asaa` is a questionnaire represented as a state machine. The series of questions is determined by the answers given; questions that are not relevant based on the answers previously given are not asked. When all answers are provided, the state machine can provide a score (based on a predetermined weighting for each possible answer), and a list of the (up to) 3 questions where an improvement would have the biggest impact on the overall score.

`asaa` used the ChatGPT Assistants API to provide a conversational interface on top of this state machine. The ChatGPT assistant has access to functions that allow it to fetch the next question to ask, record answers and retrieve the score and top questions for improvement.

## Getting started

You will need an [Open AI API](https://openai.com/blog/openai-api) key to run `asaa`. This needs to be set as an environment variable (I recommend using [direnv](https://direnv.net/)):

```bash
export OPENAI_API_KEY=<YOUR-KEY-HERE>
```

You can also set the model to use:

```bash
export ASAA_OPENAI_MODEL="gpt-4-turbo"
```

The default is `gpt-3.5-turbo`.

I recommend installing into a virtualenv:

```bash
python -mvenv .venv
source .venv/bin/activate
```

Install using pip:

```bash
pip install -r requirements.txt
```

This installs the `asaa` CLI. To start an assessment:
```bash
asaa start
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "asaa",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "security, AI, assistant",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/8c/d4/4df1b40f6803a9028d166789d9e20753fe3ec11145f1e28d02cda1f786a0/asaa-0.1.2.tar.gz",
    "platform": null,
    "description": "# asaa\n\nThe Application Security Assessment Assistant.\n\n## Description\n\n`asaa` helps you evaluate the security posture of your application by chatting with an AI assistant and answering a series of questions. At the end of the assessment `asaa` will give you a score and possibly some recommendations for improving your app's security posture.\n\nAt the core of `asaa` is a questionnaire represented as a state machine. The series of questions is determined by the answers given; questions that are not relevant based on the answers previously given are not asked. When all answers are provided, the state machine can provide a score (based on a predetermined weighting for each possible answer), and a list of the (up to) 3 questions where an improvement would have the biggest impact on the overall score.\n\n`asaa` used the ChatGPT Assistants API to provide a conversational interface on top of this state machine. The ChatGPT assistant has access to functions that allow it to fetch the next question to ask, record answers and retrieve the score and top questions for improvement.\n\n## Getting started\n\nYou will need an [Open AI API](https://openai.com/blog/openai-api) key to run `asaa`. This needs to be set as an environment variable (I recommend using [direnv](https://direnv.net/)):\n\n```bash\nexport OPENAI_API_KEY=<YOUR-KEY-HERE>\n```\n\nYou can also set the model to use:\n\n```bash\nexport ASAA_OPENAI_MODEL=\"gpt-4-turbo\"\n```\n\nThe default is `gpt-3.5-turbo`.\n\nI recommend installing into a virtualenv:\n\n```bash\npython -mvenv .venv\nsource .venv/bin/activate\n```\n\nInstall using pip:\n\n```bash\npip install -r requirements.txt\n```\n\nThis installs the `asaa` CLI. To start an assessment:\n```bash\nasaa start\n```\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "The Application Security Assessment Assistant",
    "version": "0.1.2",
    "project_urls": {
        "Documentation": "https://github.com/andycaine/asaa?tab=readme-ov-file#asaa",
        "Homepage": "https://github.com/andycaine/asaa",
        "Repository": "https://github.com/andycaine/asaa.git"
    },
    "split_keywords": [
        "security",
        " ai",
        " assistant"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "62cca77c39f777e5e7bf45efc6583bfc668396007d97b1c58bef449669182ce0",
                "md5": "2750fce48852980a8adbf1fd03b356ef",
                "sha256": "486ae2686ea53450aee8fc01bfd2f4a7ab8d1d78a70d4e74beb5d229ceb4d6ac"
            },
            "downloads": -1,
            "filename": "asaa-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2750fce48852980a8adbf1fd03b356ef",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 7833,
            "upload_time": "2024-04-26T17:46:14",
            "upload_time_iso_8601": "2024-04-26T17:46:14.710834Z",
            "url": "https://files.pythonhosted.org/packages/62/cc/a77c39f777e5e7bf45efc6583bfc668396007d97b1c58bef449669182ce0/asaa-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8cd44df1b40f6803a9028d166789d9e20753fe3ec11145f1e28d02cda1f786a0",
                "md5": "f1315944efcb42f8937d2da52a8e538d",
                "sha256": "d1f64a7b35ac33e6ddb994eb4b9f0996e29068be63fb6aca350f236b7e0857f7"
            },
            "downloads": -1,
            "filename": "asaa-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "f1315944efcb42f8937d2da52a8e538d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 7165,
            "upload_time": "2024-04-26T17:46:16",
            "upload_time_iso_8601": "2024-04-26T17:46:16.986614Z",
            "url": "https://files.pythonhosted.org/packages/8c/d4/4df1b40f6803a9028d166789d9e20753fe3ec11145f1e28d02cda1f786a0/asaa-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-26 17:46:16",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "andycaine",
    "github_project": "asaa?tab=readme-ov-file#asaa",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "asaa"
}
        
Elapsed time: 0.22877s