Hey Python
An AI-powered CLI assistant that helps with coding and system tasks using OpenAI's language models.
Installation
pip install hey-python
API Key Configuration
Hey CLI securely manages your OpenAI API key:
-
First-time use: You'll be prompted to enter your API key
-
Secure storage options:
- System keyring: Uses your OS's secure credential storage (preferred)
- Windows: Windows Credential Locker
- macOS: Keychain
- Linux: Secret Service API (GNOME Keyring/KDE Wallet)
- Fallback storage: When system keyring is unavailable (Docker, minimal servers)
- Uses file-based encrypted storage in
~/.hey_config/ - Machine-specific encryption (keys can't be transferred between systems)
- Uses file-based encrypted storage in
- System keyring: Uses your OS's secure credential storage (preferred)
-
Removing a saved key: Use the
--remove-api-keyoption to delete your stored keyhey --remove-api-key
Manual API Key Setup
You can also set your API key using:
- Environment variable:
export OPENAI_API_KEY=your_key_here - .env file: Create a
.envfile in your working directory:OPENAI_API_KEY=your_api_key_here
Usage
After installation, use the hey command followed by your question or instruction:
# Ask for help
hey help me understand how to use this tool
# Create a simple script
hey create a hello world script in python
# Get system information
hey what files do I have in this directory?
# Create files for a project
hey create a new React component for a login form
Features
- Secure API Key Management: Keys stored in system's secure credential manager
- Intelligent File Operations: Create, edit, delete, and rename files
- Directory Management: Create and remove directories
- Command Execution: Run shell commands directly
- Context-Aware: Maintains conversation history for better assistance
- Syntax Highlighting: Shows diffs and code with proper formatting
- Streaming Responses: See AI responses in real-time
Examples
# Create a Python script
hey create a script that downloads images from a URL
# Fix errors in code
hey debug this file and fix the bugs: app.js
# Get explanations
hey explain how the authentication works in this project
# Execute commands
hey show me the disk usage in this directory
License
MIT License - See LICENSE.rst for details.
Metadata
Release files for hey-python 1.0.3
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 |
|---|---|---|---|---|
| hey_python-1.0.3.tar.gz | 20.7 kB | Without provenance | Details for hey_python-1.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hey_python-1.0.3-py3-none-any.whl | Python 3 | none | any | Details for hey_python-1.0.3-py3-none-any.whl |
Total release size: 44.5 kB
Release files / hey_python-1.0.3.tar.gz
| Download URL | hey_python-1.0.3.tar.gz |
|---|---|
| Size | 20.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
23cda34ce200ce30ec2ef25e4c414e4b7e62f2498c0b701ca6853d738f6b2db2
|
|
BLAKE2b-256 checksum How to use checksums |
4ed33c6fbf9cc5a0cd5e6247551a4e67382c6180480b6ea731bf66c202f9c576
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.0
|
Release files / hey_python-1.0.3-py3-none-any.whl
| Download URL | hey_python-1.0.3-py3-none-any.whl |
|---|---|
| Size | 23.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c265172e632d7692a16b1b82e60345ccfe3cc75676ac5a9ce28003b85002fcb0
|
|
BLAKE2b-256 checksum How to use checksums |
380d54a2f57bc1582771e17a899f3efa597d8a64fdd200954713418d1dd7f1c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.0
|
Security for hey-python 1.0.3
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A 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.