🤖 Iva - AI Code Assistant

Iva is a powerful AI-powered code assistant that helps developers generate code and project structures using natural language descriptions.

✨ Features

• 🚀 Generate complete project structures from natural language
• 💻 Interactive CLI with rich formatting
• 🔧 Smart code generation and bug fixing
• 📁 Project scaffolding for various frameworks
• 🌐 Cross-platform support
• 🤖 Support for multiple LLM models

📦 Installation

From PyPI (Recommended)

pip install iva-generator

From Source

1. Clone the repository:

git clone https://github.com/ItzCyzmiX/Iva.git
cd Iva

2. Install in development mode:

pip install -e .

🚀 Quick Start

Using the CLI

# If installed from PyPI
iva

# If installed from source
python -m iva

Using in Your Code

from iva_generator import AIFileGenerator

# Initialize the generator
generator = AIFileGenerator()

# Generate code
generator.run("Create a Flask API with authentication", output_dir="my_project")

💡 Examples

Creating a Basic API

$ iva
What would you like me to do? Create a FastAPI backend with user authentication
Output directory: ./my_api
✅ Files generated successfully!

Generating a React Component

$ iva
What would you like me to do? Create a React todo list component with TypeScript
Output directory: ./components
✅ Files generated successfully!

🔑 Environment Variables

1. Create a .env file in your working directory (where you'll run the iva command):

GROQ_API_KEY=your-api-key-here

2. Or set environment variables in your system:

Windows (PowerShell):

$env:GROQ_API_KEY="your-api-key-here"

Windows (Command Prompt):

set GROQ_API_KEY=your-api-key-here

Linux/MacOS:

export GROQ_API_KEY="your-api-key-here"

3. Or set them in your Python code:

import os
os.environ["GROQ_API_KEY"] = "your-api-key-here"

from iva_generator import AIFileGenerator
generator = AIFileGenerator()

Note: Get your Groq API key from Groq's website. Never commit your .env file or share your API key.

Tip: For permanent setup on Windows, you can set the environment variable through:

1. Search for "Environment Variables" in Windows
2. Click "Environment Variables..."
3. Under "User variables" click "New"
4. Variable name: GROQ_API_KEY
5. Variable value: your-api-key-here

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with LangChain
• Powered by Groq

📫 Contact

ItzCyzmiX - @ItzCyzmiX - itzmedigamingx@gmail.com

Project Link: https://github.com/ItzCyzmiX/Iva