Skip to content

epavanello/fixodev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

FixO Dev

FixO Dev Bot Banner

๐Ÿค– AI-Powered Code Fixes, Delivered as Pull Requests

Transform your development workflow with instant, intelligent code improvements

License: BSL-1.1 GitHub stars GitHub issues GitHub pull requests Discord dev.to

๐Ÿ“– Documentation โ€ข ๐Ÿ’ฌ Community โ€ข ๐Ÿ› Report Bug


๐ŸŒŸ About the Project

FixO Dev Bot is revolutionizing how developers handle code quality and maintenance. Instead of spending hours on repetitive fixes, linting, and formatting, simply mention @fixodev in any GitHub issue or PR, and watch as our AI-powered bot delivers professional-grade improvements directly as pull requests.

๐ŸŽฏ Our Mission

To eliminate the friction between identifying code issues and implementing solutions, making high-quality code accessible to every developer and project.

We believe that:

  • ๐Ÿ”ง Code quality shouldn't be a luxury - Every project deserves clean, maintainable code
  • โšก Automation beats manual work - Developers should focus on creativity, not repetitive tasks
  • ๐Ÿค AI should augment, not replace - Intelligent assistance that learns from your codebase
  • ๐ŸŒ Open source drives innovation - Community-driven development creates better tools

โœจ Why FixO Dev Bot?

๐Ÿš€ Instant Impact

  • Zero setup required - Works with any GitHub repository
  • Mention and done - Just type @fixodev in issues or PRs
  • Professional results - AI-powered fixes that follow best practices
  • Multiple languages - TypeScript, JavaScript, Python, and more

๐Ÿ›ก๏ธ Secure & Reliable

  • Containerized execution - Isolated, secure code processing
  • No data retention - Your code stays private
  • Open source - Full transparency in how your code is handled
  • Enterprise ready - Built for teams and organizations

๐ŸŽฌ See It In Action

demo.fixo.mp4

Watch FixO Dev Bot in action - from mention to pull request in minutes!

# 1. Mention @fixodev in any GitHub issue or PR comment
# 2. Watch the magic happen!

# Example: In a GitHub issue
"Hey @fixodev, can you refactor the code to use the new API?"

# Result: Professional PR with fixes in minutes โœจ

๐Ÿš€ Quick Start

For Repository Owners

  1. Install the GitHub App on your repository (required only for private repos)
  2. Configure (optional) by adding .fixodev.yml to your repo root
  3. Trigger the bot by mentioning @fixodev in:
    • ๐Ÿ’ฌ Issue comments
    • ๐Ÿ”„ Pull request comments
    • ๐Ÿ“ New issues

For Contributors & Testers

We're actively seeking contributors and testers! Here's how you can help:

  • ๐Ÿงช Beta Testers: Try the bot on your projects and report feedback
  • ๐Ÿ› ๏ธ Developers: Contribute to the core platform or integrations
  • ๐Ÿ“š Documentation: Help improve our guides and examples
  • ๐ŸŽจ Designers: Enhance our UI/UX and visual identity
  • ๐ŸŒ Community: Share your experience and help others

Join our Discord to get started!


๐Ÿ—๏ธ Architecture & Technology

graph TB
    A[GitHub Webhook] --> B[FixO Server]
    B --> C[Job Queue]
    C --> D[Docker Container]
    D --> E[AI Analysis]
    E --> F[Code Fixes]
    F --> G[Pull Request]

    subgraph "Secure Execution"
        D
        E
        F
    end
Loading

๐Ÿ”ง Tech Stack

  • Runtime: Bun + TypeScript for blazing-fast performance
  • Framework: Hono for lightweight, efficient HTTP handling
  • Containerization: Docker for secure, isolated code execution
  • AI Integration: OpenRouter models with custom prompt engineering
  • Database: SQLite with Drizzle ORM for simplicity
  • Frontend: SvelteKit with TailwindCSS for modern UI

๐Ÿ›๏ธ Core Components

  • ๐ŸŽฃ GitHub App Server: Webhook handling and authentication
  • โšก Queue System: Reliable job processing with retry mechanisms
  • ๐Ÿณ Docker Orchestration: Secure, isolated script execution
  • ๐Ÿง  LLM Integration: Intelligent code analysis and improvements
  • ๐Ÿ”„ Git Operations: Automated branch management and PR creation

๐ŸŽฏ Roadmap & Changelog

๐Ÿš€ Current Status (v0.1.0)

  • โœ… Core GitHub App functionality
  • โœ… Basic AI-powered code fixes
  • โœ… Docker containerization
  • โœ… Automated PR creation

๐Ÿš€ Current Status (v0.2.0)

  • โœ… Full thread context - Complete issue conversation awareness for better AI understanding
  • โœ… Iterative PR improvements - Add comments to request changes and refinements
  • โœ… AI reasoning transparency - Show agent's thought process and considerations in PR discussions for debugging
  • โœ… Usage tracking - Display job costs and remaining free tier interactions

๐Ÿ”ฎ Coming Soon (v0.3.0)

  • ๐Ÿ“ Line-specific feedback - Comment on specific code lines for targeted improvements
  • ๐ŸŽฏ Code-level tagging - Tag the bot on specific lines to generate targeted PRs
  • ๐Ÿ’Ž Subscription system - Premium access for private repos and advanced AI models
  • ๐Ÿ’ก Suggestion system - Automatically suggests in case issues are opened not using fixodev, the suggestion must be a comment on the issue

๐ŸŒŸ Future Vision (v1.0+)

  • TBD

๐Ÿค Contributing

We believe the best tools are built by the community, for the community. Whether you're a seasoned developer or just starting out, there's a place for you in the FixO Dev Bot project!

๐ŸŒŸ Ways to Contribute

๐Ÿงช Testing & Feedback

  • Try the bot on your projects
  • Report bugs and edge cases
  • Suggest new features
  • Share your experience

๐Ÿ’ป Development

  • Fix bugs and implement features
  • Improve performance and reliability
  • Add support for new languages
  • Enhance AI capabilities

๐Ÿ“š Documentation

  • Write tutorials and guides
  • Improve API documentation
  • Create video content
  • Translate to other languages

๐Ÿš€ Getting Started

# Clone the repository
git clone https://github.com/epavanello/fixodev.git
cd fixodev

# Install dependencies
bun install

# Set up environment variables
cp env.example .env
# Edit .env with your configuration

# Start development server
bun run dev:server

# Start web app (in another terminal)
bun run dev:web

๐Ÿ“‹ Development Setup

  1. Prerequisites: Bun, Docker, GitHub App credentials
  2. Environment: Copy env.example to .env and configure
  3. Database: Run bun run db:migrate to set up the database
  4. Testing: Use bun test to run the test suite

Read our Contributing Guide for detailed instructions.


๐Ÿ’ฐ Business Model & Sustainability

๐Ÿ†“ Free Tier

  • โœ… Free use on public repositories with usage limits
  • โœ… Basic AI-powered fixes
  • โœ… Community support
  • โœ… Standard processing queue

๐Ÿ’Ž Pro Tier (Coming 2025)

  • ๐Ÿ”’ Private repository support
  • โšก Priority processing queue
  • ๐Ÿ“Š Advanced analytics and insights
  • ๐Ÿ‘ฅ Team management features
  • ๐ŸŽฏ Custom fix patterns
  • ๐Ÿ“ž Priority support

๐Ÿ“Š Project Stats

GitHub Repo stars GitHub forks GitHub issues GitHub pull requests


๐Ÿ† Recognition & Community

๐Ÿ‘ฅ Community

Discord Twitter


๐Ÿ™ Sponsors & Supporters

๐Ÿ’Ž Platinum Sponsors

Become our first platinum sponsor and get your logo here!

๐Ÿฅ‡ Gold Sponsors

Support the future of automated code quality

๐Ÿฅˆ Silver Sponsors

Help us build the tools developers deserve

Become a Sponsor and help us build the future of automated code quality!


๐Ÿ“„ License

This project is licensed under the Business Source License 1.1 (BSL-1.1).

  • โœ… Free for non-commercial use - Perfect for open source projects, learning, and personal use
  • โœ… Source available - Full transparency and community contributions welcome
  • โœ… Converts to AGPL v3 - Becomes fully open source on January 1, 2035
  • ๐Ÿ’ผ Commercial licensing available - Contact us for enterprise use

Read the full license โ€ข Contact for commercial licensing


๐Ÿš€ Get Started Today

Ready to transform your development workflow?

Install GitHub App Join Discord Star on GitHub

๐Ÿ“– Read the Docs โ€ข ๐ŸŽฌ Watch Demo โ€ข ๐Ÿ’ฌ Get Support


Built with โค๏ธ by @epavanello and the community

Making high-quality code accessible to everyone, one pull request at a time.