Skip to main content

AI Code Assistant

Project description

🤖 Iva - AI Code Assistant

PyPI version Python 3.8+ License: MIT

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
  1. 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
  1. 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"
  1. 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

📫 Contact

ItzCyzmiX - @ItzCyzmiX - itzmedigamingx@gmail.com

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iva_generator-0.1.2.tar.gz (8.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iva_generator-0.1.2-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

Details for the file iva_generator-0.1.2.tar.gz.

File metadata

  • Download URL: iva_generator-0.1.2.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for iva_generator-0.1.2.tar.gz
Algorithm Hash digest
SHA256 d952ee2840c1ea24ccda1f4147d9cceecaea0e8ed00e3ad914e608ecfdf2793f
MD5 c8f592ef9f4ef31b815d1a651b4cb6ae
BLAKE2b-256 83647050afe3d8dfe52a9ca7bfe7dbd099bd4fb95977e6bb19dfbb876cd5095f

See more details on using hashes here.

File details

Details for the file iva_generator-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: iva_generator-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 9.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for iva_generator-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 96cb46dc195718aeb700047bc1e6b8806e441cb72e46e5f050332cf9a6c11b7b
MD5 8e23ab1355776e52bdcccb72fcdffc61
BLAKE2b-256 4fb111499a501256bf33633dc372f093211f5415845c2ca613b75c4d6b61d921

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page