Metadata-Version: 2.4
Name: apilibrary
Version: 1.4.0
Summary: A simple library to securely store and retrieve API keys
Author-email: Lokesh <lokeshpantangi@gmail.com>
Project-URL: Homepage, https://github.com/lokeshpantangi/apilibrary
Project-URL: Repository, https://github.com/lokeshpantangi/apilibrary.git
Project-URL: Issues, https://github.com/lokeshpantangi/apilibrary/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cryptography>=3.4.8
Requires-Dist: click>=8.0.0
Dynamic: license-file

# API Library

A simple and secure Python library for storing and retrieving API keys with automatic provider detection.

## Features

- 🔐 **Secure Storage**: API keys are encrypted before storage
- 🔑 **Password Protection**: Master password required for fetching/deleting keys
- 🤖 **Auto-Detection**: Automatically detects API provider from key format
- 🚀 **Direct Commands**: Use `storekey` and `fetchkey` commands directly
- 🔒 **Local Storage**: Keys stored locally in encrypted format
- 🌐 **Multi-Provider**: Supports OpenAI, Claude, Google AI, Hugging Face, and more
- 🛡️ **First-time Setup**: Mandatory password creation on first use

## Installation

### From PyPI (Recommended)
```bash
pip install apilib
```

### From Source
```bash
git clone https://github.com/lokeshpantangi/apilib.git
cd apilib
pip install .
```

## Usage

### First-Time Setup

On your first use, you'll be prompted to create a master password:

```bash
fetchkey openai  # Will trigger password setup if first time
```

Or manually set up the password:

```bash
setuppassword
```

### Store an API Key

```bash
storekey openai "sk-1234567890abcdef..."
storekey claude "sk-ant-api03-1234567890abcdef..."
storekey google "AIza1234567890abcdef..."
```

Specify the provider name and the API key. The library will store the key securely with the specified provider. **No password required for storing.**

### Retrieve API Keys

```bash
fetchkey openai
```

This will prompt for your master password and then display all stored API keys for the specified provider. **Password required for fetching.**

### Password Management

```bash
# Check authentication status
checkauth

# Change your master password
changepassword
```

### Supported Providers

- **OpenAI**: `sk-...` format
- **Claude (Anthropic)**: `sk-ant-...` format
- **Google AI**: `AIza...` format
- **Hugging Face**: `hf_...` format
- **Cohere**: 40-character alphanumeric
- **Replicate**: `r8_...` format
- **Stability AI**: `sk-...` format (32 chars)

## Examples

```bash
# Store different API keys
storekey openai "sk-1234567890abcdef1234567890abcdef1234567890abcdef"
storekey claude "sk-ant-api03-1234567890abcdef..."
storekey google "AIza1234567890abcdef1234567890abcdef123"
storekey huggingface "hf_1234567890abcdef..."
storekey customapi "your-custom-api-key-here"

# Retrieve keys by provider
fetchkey openai
fetchkey claude
fetchkey google
fetchkey huggingface
fetchkey customapi
```

## Security

- API keys are encrypted using Fernet (symmetric encryption)
- Keys are stored locally in `~/.apilib/keys.json`
- Encryption key is derived from system-specific information
- Keys are masked when displayed for security

## Development

### Project Structure

```
apilib/
├── apilib/
│   ├── __init__.py      # Package initialization
│   ├── commands.py      # CLI command handlers
│   ├── core.py          # Main API key manager
│   ├── crypto.py        # Encryption/decryption
│   ├── detector.py      # API provider detection
│   └── storage.py       # File storage operations
├── setup.py             # Package configuration
└── README.md           # This file
```

### Dependencies

- `cryptography>=3.4.8` - For encryption
- `click>=8.0.0` - For CLI interface

## License

MIT License
