Repository navigation
Releases
Releases · herson/anansi
Anansi 0.2.0
Changed (breaking)
- Python 3.11 or later is required (ADR-0011). Python 3.10 is end of life, and the fixed releases of pillow and dnspython no longer support it, so 3.10 installs got versions with known vulnerabilities. The Docker image is unaffected.
- Scan results are a list of findings (ADR-0003).
reports/report.json, stored scan history andGET /api/scan/{id}now return a list of objects withhost,port,protocol,service,product,versionandcves, instead of an object keyed by port. Multi-host scans no longer overwrite each other. The CSV report gainsHost,ProtocolandProductcolumns. History saved before this change keeps its old shape.
Added
- AI analysis with any OpenAI-compatible endpoint (ADR-0005, ADR-0006): new
ai_base_url,ai_api_key_envandai_token_parametersettings send--aito OpenRouter or a local model such as Ollama, so scan data can stay on your machine. OpenAI remains the default, and its key is never sent to another endpoint. Invalid AI settings stop--aibefore the scan starts. - Community Health: Added
CODE_OF_CONDUCT.md,SECURITY.md, andFUNDING.yml. - Automation: Added GitHub Action for CI (
.github/workflows/ci.yml) to run tests and linting on every push. - Templates: Added Issue templates for Bug Reports and Feature Requests, and a Pull Request template.
- Documentation: Enhanced
CONTRIBUTING.mdwith detailed setup and testing instructions.
Changed
- Dependencies are locked with hashes (ADR-0010):
requirements.txtis now generated fromrequirements.inbyscripts/lock-requirements.shand pins every package with hashes for every supported Python version. CI tools are locked inrequirements-dev.txt, and mkdocs moved out of the runtime image torequirements-docs.txt. Edit the.infiles, then re-lock. - CI fails on lint findings: flake8 now blocks the build, with its settings in
.flake8so local runs match CI. Actions are pinned to commit SHAs, and the workflow token can only read the repository. - CI tests Python 3.11 through 3.14, every version from the minimum to the newest release.
- CI runs weekly on
mainas well as on every push and PR, so pip-audit flags a new advisory against a locked dependency without waiting for the next change. - The Docker image runs Python 3.14, the newest version CI tests, instead of 3.12.
- Refactored
CONTRIBUTING.mdto.github/CONTRIBUTING.mdfor better GitHub integration. - Updated
README.mdwith build status badges and sponsorship information.
Fixed
- Readable JSON on the console:
--compliance,--dnsand--s3printed\u2013and\u00a7instead of–and§. - The mkdocs pages describe the real code: they documented functions and flags that never existed (
scan_network(),--enumerate). Pages that repeated the README are gone, the module pages show the actual classes andFindingrecords, and a test checks that every flag, import and link indocs/exists. - The dashboard starts from any working directory: it found its templates relative to the directory it was started from, and importing
web/app.pyopenedanansi.dbthere. The database now opens when the app starts, and the scheduler starts and stops with it through a lifespan handler instead of the deprecatedon_eventhooks. - PDF reports render any text:
fpdf1.7.2 is replaced byfpdf2with an embedded DejaVu Sans font, so CVE descriptions, service banners and compliance controls outside Latin-1 no longer crash--pdf. --pdf --complianceincludes the compliance mapping: it was added after the file was saved, so it never appeared.--pdfworks on CIDR targets: the report for10.0.0.0/24is nowreport_10.0.0.0_24.pdfinstead of a crash on the/.--s3no longer reports a bucket as clean when a check fails: failed checks are listed undererrorsand the command exits with status 1. It now checks all four public access block settings, grants to any AWS account, and whether the bucket policy is public, which needs thes3:GetBucketPolicyStatuspermission.- Scheduled and manual scans no longer run at the same time: a scheduled scan that fires while another scan runs is skipped with a warning in the log, instead of overwriting the running scan's progress and results and letting a third scan start.
- Scheduled scans survive restarts (ADR-0004): schedules are saved in the scan database and restored when the dashboard starts. Before, every restart or image update silently dropped them.
--aiworks again with the default config: OpenAI shut downgpt-3.5-turboon 2026-10-23. The default is nowgpt-6-luna, and requests cap output withmax_completion_tokens, which current reasoning models require instead ofmax_tokens. A customai_modelinconfig.yamlmust accept that parameter.--aianalyses what the scan verified: the model now receives each service's product name and, with--cve, the CVEs found in the NVD. Before, it saw onlyhttp 2.4.49and had to recall vulnerabilities from memory, so it could miss them or cite wrong ones.- An unknown
report_formatis an error: a value other thanjsonorcsvinconfig.yamlused to skip the report without a word. The CLI now says so and exits before the scan starts.