https://github.com/divkix/ai-code-improvement-platform
AI powered code improvement platform using Voyage AI, Qdrant, MongoDB and Claude Sonnet 4
https://github.com/divkix/ai-code-improvement-platform
Last synced: about 2 months ago
JSON representation
AI powered code improvement platform using Voyage AI, Qdrant, MongoDB and Claude Sonnet 4
- Host: GitHub
- URL: https://github.com/divkix/ai-code-improvement-platform
- Owner: Divkix
- Created: 2025-07-21T06:42:04.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-11-20T02:14:21.000Z (7 months ago)
- Last Synced: 2026-03-15T09:51:41.634Z (3 months ago)
- Language: Go
- Homepage:
- Size: 13.2 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI Code Fixing Platform
An automated code fixing engine that transforms from "smart text search" into AI-powered code fixing with AST-based analysis, knowledge graphs, and validated solution generation. Delivers complete, tested fixes for technical debt and code quality issues.
## Table of Contents
- [AI Code Fixing Platform](#ai-code-fixing-platform)
- [Table of Contents](#table-of-contents)
- [✨ Key Features](#-key-features)
- [🏗️ Tech Stack](#️-tech-stack)
- [📂 Repository Layout (top-level)](#-repository-layout-top-level)
- [🚀 Quick Start (Production-like)](#-quick-start-production-like)
- [Local Development Hot-Reload](#local-development-hot-reload)
- [🛠️ Backend Development](#️-backend-development)
- [Environment Variables (partial list)](#environment-variables-partial-list)
- [API Documentation](#api-documentation)
- [🌐 Frontend Development](#-frontend-development)
- [Regenerate Typed API Client](#regenerate-typed-api-client)
- [🧪 Testing All Services](#-testing-all-services)
- [🖥️ Makefile Cheat-Sheet](#️-makefile-cheat-sheet)
- [🤝 Contributing](#-contributing)
- [📄 License](#-license)
---
## ✨ Key Features
- **Automated Code Fixing** – AST-based problem detection with AI-generated solutions and comprehensive validation
- **Knowledge Graph Analysis** – understand code relationships, dependencies, and architectural patterns through Neo4j integration
- **Multi-Modal Understanding** – combines code structure, comments, tests, and documentation for complete context
- **Fix Validation System** – syntax, compilation, behavioral, and security validation ensuring safe code changes
- **Hierarchical Code Summarization** – semantic clustering from individual functions to system-wide architecture
- **Program Dependence Graphs** – control and data flow analysis for precise change impact prediction
- **Incremental Analysis** – real-time repository updates with smart caching and change propagation
- **Repository-Level Reasoning** – CodePlan-inspired planning for complex architectural queries and multi-step fixes
- **GitHub OAuth Integration** – secure repository access with automated import and progress tracking
- **Type-Safe API** – OpenAPI-first development with generated types for backend and frontend
---
## 🏗️ Tech Stack
| Layer | Technology |
|-------------|------------|
| **Frontend**| SvelteKit + TypeScript, TailwindCSS, openapi-fetch |
| **Backend** | Go 1.24+ (Gin), MongoDB, Qdrant, Neo4j, Tree-sitter AST parsers |
| **AI/ML** | OpenAI-compatible LLM, Voyage AI embeddings, AST-based analysis |
| **Analysis**| Program dependence graphs, control/data flow analysis, semantic clustering |
| **Auth** | JWT sessions, GitHub OAuth for repository access |
| **Infra** | Docker Compose, multi-service orchestration, hot-reload development |
---
## 📂 Repository Layout (top-level)
```
backend/ # Go services, API, generation & Dockerfiles
frontend/ # SvelteKit application
mongodb-init/ # Mongo seed user scripts
Makefile # helper commands (docker compose, build, test)
docker-compose[.dev].yml # multi-service orchestration
```
---
## 🚀 Quick Start (Production-like)
The simplest way to spin everything up is Docker Compose:
```bash
# Build & start in the background
make up # defaults to env=prod → docker-compose.yml
# Tail logs
make logs
# Shutdown
make down
```
The **prod** stack uses the regular `Dockerfile` images for both frontend and backend.
### Local Development Hot-Reload
```bash
# Start dev versions (hot-reload, vite, go run, etc.)
make up env=dev # uses docker-compose.dev.yml
```
Behind the scenes the dev compose file mounts your source directories and uses **`Dockerfile.dev`** images that have nodemon / reflex / vite dev servers.
---
## 🛠️ Backend Development
```bash
cd backend
# Run unit tests with race detector & coverage
make test
# Lint & vet
make validate
# Hot-reload standalone (without docker)
make backend-dev
```
### Environment Variables (partial list)
| Variable | Default | Description |
|----------|---------|-------------|
| `PORT` | 8080 | HTTP listen port |
| `MONGODB_URI` | mongodb://localhost:27017/acip | Mongo connection string |
| `QDRANT_URL` | http://localhost:6334 | Qdrant vector database |
| `NEO4J_URI` / `NEO4J_USER` / `NEO4J_PASSWORD` | bolt://localhost:7687 / neo4j / password | Neo4j knowledge graph database |
| `JWT_SECRET` | *required* | HMAC secret for JWT tokens |
| `GITHUB_CLIENT_ID` / `GITHUB_CLIENT_SECRET` | – | GitHub OAuth credentials |
| `LLM_API_KEY` | *required* | API key for OpenAI-compatible LLM |
| `EMBEDDING_API_KEY` | – | API key for embedding provider |
| `ENABLE_AST_ANALYSIS` | true | Enable AST-based code analysis |
| `ANALYSIS_DEPTH` | semantic | Analysis depth: basic, ast, semantic, full |
| `TREE_SITTER_PATH` | /usr/local/lib/tree-sitter | Path to tree-sitter parsers |
See `backend/internal/config/config.go` for the full configuration matrix.
### API Documentation
Swagger-UI is automatically served at:
```
http://localhost:8080/docs/
```
The spec lives in `backend/api/openapi.yaml`. Convert to JSON via:
```bash
make -C backend openapi-json
```
---
## 🌐 Frontend Development
```bash
cd frontend
bun install # or npm / pnpm / yarn
cp .env.example .env.local
bun run dev # localhost:3000
```
`VITE_API_URL` must point to the backend URL (defaults to `http://localhost:8080`).
### Regenerate Typed API Client
```bash
bun run generate-api # parses backend OpenAPI spec → src/lib/api/types.ts
```
Unit tests: `bun run test:unit`
E2E tests (Playwright): `bun run test:e2e`
---
## 🧪 Testing All Services
1. Ensure **MongoDB**, **Qdrant** & **Neo4j** services are running (`make up env=dev`).
2. Run backend tests: `make test`.
3. Run frontend unit & e2e tests: `cd frontend && bun run test`.
4. Validate fix generation and AST analysis: `make validate`.
---
## 🖥️ Makefile Cheat-Sheet
```
make up [env=dev|prod] # build & start stack
make down [env=..] # stop stack
make clean # down + remove volumes
make logs service= # follow logs
make generate # go generate API stubs
make backend-dev # run backend with hot reload
```
---
## 🤝 Contributing
1. Fork & clone the repo.
2. Create a feature branch: `git checkout -b feat/my-feature`.
3. Run `make validate` to ensure code passes lints/tests.
4. Submit a pull request – please describe the motivation and include screenshots / logs where relevant.
---
## 📄 License
This project is licensed under the MIT License. See the `LICENSE` file for details.