autogenlib 0.1.3
Import wisdom, export code.
Requires Python: >=3.12

# AutoGenLib

> The only library you'll need ever.
>
> Import wisdom, export code.

AutoGenLib is a Python library that automatically generates code on-the-fly using OpenAI's API. When you try to import a module or function that doesn't exist, AutoGenLib creates it for you based on a high-level description of what you need.

## Features

- **Dynamic Code Generation**: Import modules and functions that don't exist yet
- **Context-Aware**: New functions are generated with knowledge of existing code
- **Progressive Enhancement**: Add new functionality to existing modules seamlessly
- **No Default Caching**: Each import generates fresh code for more varied and creative results
- **Full Codebase Context**: LLM can see all previously generated modules for better consistency
- **Caller Code Analysis**: The LLM analyzes the actual code that's importing the module to better understand the context and requirements
- **Automatic Exception Handling**: All exceptions are sent to LLM to provide clear explanation and fixes for errors.

## Installation

```bash
pip install autogenlib
```

Or install from source:

```bash
git clone https://github.com/cofob/autogenlib.git
cd autogenlib
pip install -e .
```

## Requirements

- Python 3.12+
- OpenAI API key

## Quick Start

Set OpenAI API key in `OPENAI_API_KEY` env variable.

```python
# Import a function that doesn't exist yet - it will be automatically generated
from autogenlib.tokens import generate_token

# Use the generated function
token = generate_token(length=32)
print(token)
```

## How It Works

1. You initialize AutoGenLib with a description of what you need
2. When you import a module or function under the `autogenlib` namespace, the library:
   - Checks if the module/function already exists
   - If not, it analyzes the code that's performing the import to understand the context
   - It sends a request to OpenAI's API with your description and the context
   - The API generates the appropriate code
   - The code is validated and executed
   - The requested module/function becomes available for use

## Examples

### Generate a TOTP Generator

```python
from autogenlib.totp import totp_generator

print(totp_generator("SECRETKEY123"))
```

Add a Verification Function Later

```python
# Later in your application, you need verification:
from autogenlib.totp import verify_totp
result = verify_totp("SECRETKEY123", "123456")
print(f"Verification result: {result}")
```

### Using Context-Awareness

```python
# Import a function - AutoGenLib will see how your data is structured
from autogenlib.processor import get_highest_score

# Define your data structure
data = [{"user": "Alice", "score": 95}, {"user": "Bob", "score": 82}]

# The function will work with your data structure without you having to specify details
print(get_highest_score(data))  # Will correctly extract the highest score
```

### Create Multiple Modules

```python
# You can use init function to additionally hint the purpose of your library
from autogenlib import init
init("Cryptographic utility library")

# Generate encryption module
from autogenlib.encryption import encrypt_text, decrypt_text
encrypted = encrypt_text("Secret message", "password123")
decrypted = decrypt_text(encrypted, "password123")
print(decrypted)

# Generate hashing module
from autogenlib.hashing import hash_password, verify_password
hashed = hash_password("my_secure_password")
is_valid = verify_password("my_secure_password", hashed)
print(f"Password valid: {is_valid}")
```

## Configuration

### Setting the OpenAI API Key

Set your OpenAI API key as an environment variable:

```bash
export OPENAI_API_KEY="your-api-key-here"
# Optional
export OPENAI_API_BASE_URL="https://openrouter.ai/api/v1"  # Use OpenRouter API
export OPENAI_API_KEY="openai/gpt-4.1"
```

Or in your Python code (not recommended for production):

```python
import os
os.environ["OPENAI_API_KEY"] = "your-api-key-here"
```

### Caching Behavior

By default, AutoGenLib does not cache generated code. This means:

- Each time you import a module, the LLM generates fresh code
- You get more varied and often funnier results due to LLM hallucinations
- The same import might produce different implementations across runs

If you want to enable caching (for consistency or to reduce API calls):

```python
from autogenlib import init
init("Library for data processing", enable_caching=True)
```

Or toggle caching at runtime:

```python
from autogenlib import init, set_caching
init("Library for data processing")

# Later in your code:
set_caching(True)  # Enable caching
set_caching(False)  # Disable caching
```

When caching is enabled, generated code is stored in `~/.autogenlib_cache`.

## Limitations

- Requires internet connection to generate new code
- Depends on OpenAI API availability
- Generated code quality depends on the clarity of your description
- Not suitable for production-critical code without review

## Advanced Usage

### Inspecting Generated Code

You can inspect the code that was generated for a module:

```python
from autogenlib.totp import totp_generator
import inspect
print(inspect.getsource(totp_generator))
```

## How AutoGenLib Uses the OpenAI API

AutoGenLib creates prompts for the OpenAI API that include:

1. The description you provided
2. Any existing code in the module being enhanced
3. The full context of all previously generated modules
4. The code that's importing the module/function (new feature!)
5. The specific function or feature needed

This comprehensive context helps the LLM generate code that's consistent with your existing codebase and fits perfectly with how you intend to use it.

## Contributing

Contributions are not welcome! This is just a fun PoC project.

## License

MIT License

---

*Note: This library is meant for prototyping and experimentation. Always review automatically generated code before using it in production environments.*

*Note: Of course 100% of the code of this library was generated via LLM*