Skip to content

💁 Brag AI🔗

Generate and maintain a brag document automatically from your GitHub contributions, powered by AI.

Because your awesome work deserves to be remembered! ✨

Brag AI Hero

Overview🔗

Ever had that moment when your manager asks "So, what have you been up to?" and your mind goes blank?

Brag AI is your personal achievement historian! It helps you create and maintain a "brag document" - a fancy record of all the cool stuff you've done. It dives into your GitHub activity and transforms those cryptic commit messages into beautiful, human-readable achievements that will make your portfolio shine! ✨

Perfect for:

  • 📊 Performance reviews (without the last-minute panic)
  • 💼 Job applications (show off with style)
  • 📈 Personal development tracking (watch yourself grow!)
  • 🎉 Impressing your friends (and maybe your pet - results may vary)

Features🔗

  • 🔍 GitHub Integration: Automagically analyzes your commits to generate achievement descriptions
  • 🏠 Local Repository Support: Generate brag documents from local Git repositories
  • 🤖 AI-Powered: Turns "fix: bug in login" into "Enhanced system reliability by resolving critical authentication issues"
  • 📝 Incremental Updates: Update existing brag documents with new contributions over time
  • 💻 CLI Tool: Easy to use command-line interface

Getting Started🔗

Install brag-ai using uv, pipx or pip:

# Install the package
uv tool install brag-ai
# or
# pipx install brag-ai
# or
# pip install brag-ai

Head over to the Installation page for more details on how to install brag-ai.

After installation, you can generate a brag document from a GitHub repository with:

brag from-repo owner/repo --user github-username

Check out the Usage page for more details on how to use brag-ai.

Coming Soon™ 🚀🔗

  • 🌐 Web Interface: Because sometimes clicking is better than typing
  • 🤝 Extended GitHub Integration: Support for PR reviews, issues, and discussions
  • 🔄 Integration with other tools: GitLab, Bitbucket, and more - we don't discriminate!
  • 📝 Custom Templates: Make your brag document as unique as you are
  • 📦 Export Options: More ways to show off your achievements (JSON brag documents anyone?)
  • 🔒 Local Processing: Your precious data stays on your machine if you use local LLMs

Community🔗

Got ideas? We'd love to hear them! Check out our Contributing Guide to join the fun! 🎈

License🔗

This project is currently private (shhh... 🤫)

Support🔗

Why Brag AI?🔗

Maintaining a brag document is crucial for career development, but it's often overlooked or forgotten until it's time for a performance review. Brag AI automates this process, helping you capture your achievements while they're fresh or after a long time.

Built with ❤️ and ☕ by Ruan Comelli

Remember: It's not bragging if it's true! ✨