# Install censys with Homebrew, apt Command-line interface for the Censys APIs (censys.io). Version 2.2.19 via Homebrew; verified 2026-05-20. ## Install ```sh sudo av install brew:censys ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install censys ``` Evidence: local Homebrew formula metadata ### Linux - Debian apt (92%): ```sh sudo apt install python3-censys ``` Evidence: Debian stable package indexes: python3-censys from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz ## Package facts - **Package key:** brew:censys - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.2.19 - **Source summary:** Command-line interface for the Censys APIs (censys.io) - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-05-20T11:27:44Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - censys (cli) - censys (alias) ## Dependencies - certifi - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.2.19 - Package-manager updated: 2026-05-20 - Local data: ok - Upstream repository: https://github.com/censys/censys-python - info: No cached GitHub release or tag data was available. ## Project history and usage The Homebrew censys package installs the legacy Censys Python library CLI, a command-line interface and API wrapper for Censys Search and ASM data. ### Project history Censys began as a University of Michigan research project in 2013 and grew into an internet intelligence platform built around internet-wide scanning data. The censys-python repository packages that platform access for Python users and exposes a CLI named censys. ### Adoption history Censys' own documentation positions the data as useful for security operations, exposure management, and research access. The package facts show the Python CLI distributed through Homebrew as well as Debian and Ubuntu as python3-censys. ### How it is used Users configure Search credentials with censys config or CENSYS_API_ID and CENSYS_API_SECRET. The CLI and Python library can search, view, aggregate, and work with Censys host and certificate data, while ASM APIs remain supported. ### Why package nerds care This package is a good example of a security-data CLI whose command name outlived an API generation. The official README now warns that legacy Search v1/v2 APIs are being deprecated and points users toward the newer Censys Platform SDK and cencli, while ASM support in this library continues. ### Timeline - 2013: Censys started as a University of Michigan research project. - 2017: Public censys-python GitHub repository created. - 2026: Official README warns that Censys Search v1/v2 APIs are being deprecated and points to the Censys Platform SDK and cencli. ### Related projects - cencli is the newer Censys Platform CLI documented by Censys. - censys-platform is the newer Python SDK named in the official censys-python deprecation notice. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for censys. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/censys/censys.cfg ## Credential files - Unix: ~/.config/censys/censys.cfg ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** censys - **Version Scheme:** 0 - **Revision:** 5 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - python3-censys - 2.2.17-1: normalized package name match | Debian stable package indexes: python3-censys from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | easy-to-use and lightweight API wrapper for Censys APIs (censys.io) | https://github.com/censys/censys-python - Ubuntu apt - python3-censys - 2.2.11-1: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-censys from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | easy-to-use and lightweight API wrapper for Censys APIs (censys.io) | https://github.com/censys/censys-python ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [shodan](https://www.automicvault.com/pkg/brew/shodan/) - Shares av.db curated category or tags: cli, internet-intelligence, security. - [chaos-client](https://www.automicvault.com/pkg/brew/chaos-client/) - Shares av.db curated category or tags: api-client, cli, security. - [phylum-cli](https://www.automicvault.com/pkg/brew/phylum-cli/) - Shares av.db curated category or tags: api-client, cli, security. - [acme.sh](https://www.automicvault.com/pkg/brew/acme-sh/) - Shares av.db curated category or tags: cli, security. - [aescrypt](https://www.automicvault.com/pkg/brew/aescrypt/) - Shares av.db curated category or tags: cli, security. - [aespipe](https://www.automicvault.com/pkg/brew/aespipe/) - Shares av.db curated category or tags: cli, security. - [afflib](https://www.automicvault.com/pkg/brew/afflib/) - Shares av.db curated category or tags: cli, security. - [afl++](https://www.automicvault.com/pkg/brew/afl/) - Shares av.db curated category or tags: cli, security. - [search-that-hash](https://www.automicvault.com/pkg/brew/search-that-hash/) - Both packages touch the same language runtime or ecosystem. Shared terms: apis, certifi, cli, python, python-3-14. - [cycode](https://www.automicvault.com/pkg/brew/cycode/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, python, python-3-14, scanning. ## Combined YAML source View the package source record on GitHub. [combined/censys.yml](https://github.com/automic-vault/db/blob/main/combined/censys.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph