Metadata-Version: 2.4
Name: skyhydra-ai
Version: 0.1.1
Summary: AI Software Engineer CLI
Requires-Python: >=3.10
Requires-Dist: dotenv>=0.9.9
Requires-Dist: fastapi>=0.139.0
Requires-Dist: jinja2>=3.1.6
Requires-Dist: langchain-google-genai>=4.2.7
Requires-Dist: langchain-groq>=1.1.3
Requires-Dist: langchain>=1.3.11
Requires-Dist: langgraph>=1.2.8
Requires-Dist: rich>=15.0.0
Requires-Dist: typer>=0.26.8
Requires-Dist: uvicorn>=0.51.0
Description-Content-Type: text/markdown

# ⚡ Spark AI

**Spark AI** is an AI-powered Software Engineering CLI that helps developers create, debug, explain, and improve code directly from the terminal.

> Build applications using natural language, debug projects, understand code, and automate development workflows with AI.

---

## 🚀 Features

- 🛠️ AI Project Generator
- 🐞 AI Debugger
- 📖 Code Explainer
- 💬 AI Chat Assistant
- 📂 Project Scanning
- 🤖 LangGraph Powered Agents
- ⚡ Terminal First Experience
- 🔥 Multi-LLM Support (Groq, Gemini, OpenAI)

---

## Installation

### Using pip

```bash
pip install spark-ai
```

### Using uv

```bash
uv tool install spark-ai
```

---

# Quick Start

Generate a new application

```bash
spark create "Online Shopping Website"
```

Explain a file

```bash
spark explain app.py
```

Debug an entire project

```bash
spark debug
```

Chat with Spark

```bash
spark chat
```

---

# Example

```bash
spark create "Netflix Clone"
```

Output

```
✔ Planning Architecture...
✔ Choosing Tech Stack...
✔ Generating Frontend...
✔ Generating Backend...
✔ Creating Folder Structure...
✔ Writing Files...

Project Created Successfully 🎉
```

---

# Project Structure

```
spark-ai/
│
├── src/
│   └── spark/
│       ├── cli.py
│       ├── agent.py
│       ├── config.py
│       │
│       ├── commands/
│       │
│       ├── workflows/
│       │
│       ├── tools/
│       │
│       ├── models/
│       │
│       ├── prompts/
│       │
│       └── utils/
│
├── tests/
├── examples/
├── pyproject.toml
├── README.md
└── .env
```

---

# Tech Stack

- Python
- Typer
- LangGraph
- LangChain
- Groq
- Google Gemini
- Rich
- uv

---

# Environment Variables

Create a `.env` file in the project root.

```env
GROQ_API_KEY=your_groq_api_key

GOOGLE_API_KEY=your_google_api_key

OPENAI_API_KEY=your_openai_api_key
```

---

# Roadmap

## Version 0.1

- [x] CLI
- [x] LangGraph Integration
- [x] Chat Command
- [x] Create Command

---

## Version 0.2

- [ ] AI Debugger
- [ ] AI Code Reviewer
- [ ] File Editing Tools
- [ ] Project Scanner

---

## Version 0.3

- [ ] Multi Agent Workflow
- [ ] React Project Generator
- [ ] FastAPI Generator
- [ ] Next.js Support

---

## Version 1.0

- [ ] Autonomous Software Engineer
- [ ] Complete Project Generation
- [ ] Automatic Bug Fixing
- [ ] Git Integration
- [ ] VS Code Extension

---

# Contributing

Contributions are welcome.

1. Fork the repository
2. Create a new branch

```bash
git checkout -b feature/new-feature
```

3. Commit your changes

```bash
git commit -m "Added new feature"
```

4. Push to GitHub

```bash
git push origin feature/new-feature
```

5. Open a Pull Request

---

# License

MIT License

---

# Author

**Sumit Kumar Bajpai**

GitHub: https://github.com/sumit-069

---

## ⭐ Vision

Spark AI aims to become an **AI Software Engineer** that can understand your project, generate applications, debug code, explain complex logic, and automate software development directly from the terminal.

Instead of simply answering questions like a chatbot, Spark AI is designed to act as an intelligent development partner capable of planning, writing, editing, and improving codebases.