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

📦 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.1.tar.gz (7.3 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.1-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: iva_generator-0.1.1.tar.gz
  • Upload date:
  • Size: 7.3 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.1.tar.gz
Algorithm Hash digest
SHA256 509e263780f6d53e3a248c46c5d794b60afb045dd79d6876df6a55559eccd92d
MD5 5b76ee9dc111d50a29beb19b5d21d36d
BLAKE2b-256 460d9c92d5d89b163ae15577d8e3a0d9c90e292b6f79edab348c905e2df67e76

See more details on using hashes here.

File details

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

File metadata

  • Download URL: iva_generator-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.2 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fac0fe865c0f9e5c2fcde83669d242151df9d1facf7247821f8ffb6aebc9d348
MD5 45087bb78d1f27382cb68f31bfd664ed
BLAKE2b-256 824c6ece85e38a329b2d33bf52bea0de3e6911d9e202879928850bb9fb88228b

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