Happenstance CLI
Command-line interface for Happenstance — search your network with AI. Find warm intros for sales, source referral candidates for hiring, discover investors for fundraising, and research anyone in your network.
Install
# Homebrew (macOS / Linux)
brew tap happenstance-ai/tap
brew install happenstance
# uv
uv tool install happenstance
# pipx
pipx install happenstance
# pip
pip install happenstance
Quick start
# Configure your API key (get one at https://happenstance.ai/integrations/keys)
hpn config set --api-key YOUR_API_KEY
# Search your network
hpn search "CISOs interested in AI in the SF Bay Area"
# Research a specific person
hpn research "https://www.linkedin.com/in/garrytan/"
# Check your credit balance
hpn usage
Commands
| Command | Description |
|---|---|
hpn config set --api-key KEY |
Save your API key |
hpn config show |
Show saved API key (masked) |
hpn search "query" |
Search your network |
hpn search get ID |
Get search results |
hpn search find-more ID |
Find additional results |
hpn research "description" |
Research a person |
hpn research get ID |
Get research results |
hpn friends |
List your friends |
hpn groups |
List your groups |
hpn groups get ID |
Get group details |
hpn usage |
Show credit balance |
Configuration
The API key can be provided in three ways (in priority order):
--api-keyflag on any commandHPN_API_KEYenvironment variable- Config file at
~/.hpn/config.json(set viahpn config set)
All output is JSON and can be piped to jq for processing.
Documentation
Full API docs: https://developer.happenstance.ai
Development
See DEVELOPMENT.md for local setup, tests, and releases.
2 maintainers
Metadata
2 maintainers
Release files for happenstance 0.2.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| happenstance-0.2.5.tar.gz | 52.7 kB | With provenance | Details for happenstance-0.2.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| happenstance-0.2.5-py3-none-any.whl | Python 3 | none | any | Details for happenstance-0.2.5-py3-none-any.whl |
Total release size: 63.5 kB
Release files / happenstance-0.2.5.tar.gz
| Download URL | happenstance-0.2.5.tar.gz |
|---|---|
| Size | 52.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4c2244888bf64046ee1833cff7ae596bb6f6e4315e128746fbbfb4433554f335
|
|
BLAKE2b-256 checksum How to use checksums |
869de13779f6a16d1ce602ffcf97fef357b491590366b1f24e9efcfcfe879faf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.
Transparency logRelease files / happenstance-0.2.5-py3-none-any.whl
| Download URL | happenstance-0.2.5-py3-none-any.whl |
|---|---|
| Size | 10.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eb68a342d32a33274c4fa500ccb227e53bf8be7e1fd8d78f520ca650e7d6d8d6
|
|
BLAKE2b-256 checksum How to use checksums |
bd08757bd3f1f966a80d09c16be1c7f83e5030c0e73c9570dea6f09f3ab55c27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.
Transparency logSecurity for happenstance 0.2.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for happenstance-0.2.5.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
