Annukriti 0.1.5

AI Software Engineer CLI

⚡ 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

pip install spark-ai

Using uv

uv tool install spark-ai

---

Quick Start

Generate a new application

spark create "Online Shopping Website"

Explain a file

spark explain app.py

Debug an entire project

spark debug

Chat with Spark

spark chat

---

Example

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.

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

• CLI
• LangGraph Integration
• Chat Command
• 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

git checkout -b feature/new-feature

3. Commit your changes

git commit -m "Added new feature"

4. Push to GitHub

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.