Skip to content

FrostByte-49/Zenexis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧠 Zenexis: Autonomous AI Debugging Agent

Zenexis is a next-generation AI-powered debugging platform designed to transform how developers identify, analyze, and fix code issues. Built with a privacy-first vision, Zenexis combines intelligent code understanding, automated debugging pipelines, and an integrated development workspace to deliver a seamless debugging experience.

In a world where debugging consumes a significant portion of development time, Zenexis acts as an intelligent co-pilot by providing root cause analysis, confidence-based fixes, and automated code correction all within a developer-friendly environment.


πŸ“š Table Of Contents


✨ Features

  • 🧠 AI-Powered Debugging: Root cause analysis with detailed explanations
  • πŸ“Š Confidence Scoring: Reliability score for every generated fix
  • 🧾 Git Diff Viewer: Visualize exact code changes line-by-line
  • ⚑ Auto Debug Pipeline: One-click automatic bug detection and fixing
  • πŸ§‘β€πŸ’» VS Code-like Workspace: Integrated file explorer, editor, terminal
  • πŸ“‚ Project Import Support: Load entire directories directly
  • πŸ’¬ Chat-based Debugging: Conversational interface for code issues
  • πŸ“‘ Real-time Updates: WebSocket-based live feedback
  • πŸ’Ύ Local Persistence: IndexedDB + SQLite hybrid storage
  • πŸ” Privacy-First Design: Built for local LLM integration (future-ready)

πŸ“Έ Preview

Home Page Dashboard
Home Dashboard
Chat Interface Workspace Interface
Chat Workspace

πŸ“ Project Structure

Zenexis/
└── πŸ“Zenexis_
    β”œβ”€β”€ πŸ“backend
    β”‚   β”œβ”€β”€ πŸ“data
    β”‚   β”‚   β”œβ”€β”€ workspace.db                # Workspace storage
    β”‚   β”‚   └── zenexis.db                  # AI/debugging data
    β”‚   β”‚
    β”‚   β”œβ”€β”€ πŸ“src
    β”‚   β”‚   β”œβ”€β”€ πŸ“services
    β”‚   β”‚   β”‚   β”œβ”€β”€ ai.service.ts           # AI interaction logic
    β”‚   β”‚   β”‚   β”œβ”€β”€ pipeline.manager.ts     # Debug pipeline orchestration
    β”‚   β”‚   β”‚   └── storage.service.ts      # SQLite operations
    β”‚   β”‚   └── server.ts                   # Express + Socket.IO server
    β”‚   β”‚
    β”‚   β”œβ”€β”€ package.json
    β”‚   └── tsconfig.json
    β”‚
    β”‚
    β”œβ”€β”€ πŸ“frontend
    β”‚   β”œβ”€β”€ πŸ“public
    β”‚   β”‚   └── πŸ“assets
    β”‚   β”‚       β”œβ”€β”€ πŸ“favicon
    β”‚   β”‚       └── πŸ“images
    β”‚   β”‚
    β”‚   β”œβ”€β”€ πŸ“src
    β”‚   β”‚   β”œβ”€β”€ πŸ“components
    β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“chat
    β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“workspace
    β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“navigation
    β”‚   β”‚   β”‚   └── πŸ“ui
    β”‚   β”‚   β”‚
    β”‚   β”‚   β”œβ”€β”€ πŸ“lib
    β”‚   β”‚   β”‚   β”œβ”€β”€ ai.ts
    β”‚   β”‚   β”‚   β”œβ”€β”€ socket.ts
    β”‚   β”‚   β”‚   β”œβ”€β”€ workspaceStore.ts
    β”‚   β”‚   β”‚   └── utils.ts
    β”‚   β”‚   β”‚
    β”‚   β”‚   β”œβ”€β”€ πŸ“pages
    β”‚   β”‚   β”‚   β”œβ”€β”€ Chat.tsx
    β”‚   β”‚   β”‚   β”œβ”€β”€ Workspace.tsx
    β”‚   β”‚   β”‚   β”œβ”€β”€ Dashboard.tsx
    β”‚   β”‚   β”‚   β”œβ”€β”€ Home.tsx
    β”‚   β”‚   β”‚   └── Profile.tsx
    β”‚   β”‚   β”‚
    β”‚   β”‚   β”œβ”€β”€ App.tsx
    β”‚   β”‚   └── main.tsx
    β”‚   β”‚
    β”‚   β”œβ”€β”€ package.json
    β”‚   └── vite.config.ts
    β”‚
    β”œβ”€β”€ LICENSE
    └── README.md

βš™οΈ Technologies Used

Technology Purpose
React 19 Frontend framework
TypeScript Type safety
Vite Build tool
Tailwind CSS Styling
Monaco Editor Code editing
Zustand State management
IndexedDB (idb) Client storage
Express.js Backend API
Socket.IO Real-time communication
SQLite (better-sqlite3) Persistent storage
OpenAI API (GPT-4.1 Mini) AI debugging (MVP)
Node-PTY Terminal emulation

πŸ—οΈ System Architecture

Zenexis Architecture Diagram



πŸš€ Getting Started

A) Installation

1. Clone Repository

git clone https://github.com/FrostByte-49/zenexis.git
cd Zenexis/Zenexis_

2. Setup Backend

cd backend
npm install
npm run dev

3. Setup Frontend

cd ../frontend
npm install
npm run dev

4. Open App

http://localhost:5173

🧭 Usage Guide

A) Chat Debugging πŸ’¬

  1. Paste buggy code

  2. Submit query

  3. Receive:

    • RCA
    • Fix
    • Confidence score
    • Git diff

B) Workspace Mode πŸ§‘β€πŸ’»

  1. Import project folder
  2. View file tree (left panel)
  3. Edit code (center editor)
  4. Run commands (terminal)
  5. Use AI assistant (right panel)

C) Auto Debug Pipeline ⚑

  1. Click "Run Pipeline"

  2. System:

    • Scans files
    • Detects errors
    • Fixes automatically
    • Injects updated code

🎯 Core Features

A) Intelligent Debugging Engine

  • Multi-step reasoning pipeline
  • Context-aware fixes
  • Language-agnostic

B) Git Diff Visualization

- const x = y + 1
+ const x = Number(y) + 1

C) Real-Time Terminal

  • Powered by Node-PTY
  • Displays runtime errors
  • Integrated debugging feedback

D) Workspace System

  • File tree
  • Monaco editor
  • Live preview (optional)
  • Terminal + AI panel

πŸ” Privacy-First Approach

Zenexis is designed with local-first AI in mind:

  • IndexedDB for local storage
  • SQLite for persistent backend storage
  • Current MVP uses GPT-4.1 Mini
  • Future upgrade β†’ Fully Local LLM (Ollama / Mistral / LLaMA)

Goal: Ensure code never leaves user's machine.


🌈 Customization

A) AI Layer

  • Replace OpenAI with local LLM
  • Modify prompts in ai.service.ts

B) UI

  • Tailwind config for theming
  • Extend workspace components

C) Pipeline

  • Add linting / testing steps
  • Customize debug stages

πŸ› οΈ Future Enhancements

  • Local LLM integration (Ollama)
  • Multi-file context debugging
  • CI/CD integration
  • Plugin system
  • Team collaboration
  • Version control integration
  • Test case generation

🀝 Contributing

  1. Fork repo
  2. Create feature branch
  3. Commit changes
  4. Push and open PR

πŸ“„ License

This project is licensed under the MIT License. Feel free to use, modify, and distribute this portfolio template for personal or commercial use.

Β© 2026 Pranav Khalate

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files...

πŸ™Œ Credits

  • OpenAI (GPT-4.1 Mini)
  • Monaco Editor
  • Socket.IO
  • SQLite

πŸ“’ Author

Built With ❀️ For The Developer Community

Website GitHub LinkedIn Email Discord


🌟 Support The Project

If you find this portfolio template useful or inspiring:

  • ⭐ Star the repository on GitHub
  • πŸ”„ Fork and create your own version
  • πŸ“’ Share with fellow developers
  • πŸ’‘ Suggest improvements via issues

🌟 Vision

"Debugging shouldn't slow you down. It should evolve with you."

Zenexis is not just a tool, it's the future of autonomous debugging.

About

An Autonomous Self-Healing Debugging Code Agent

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages