Skip to content

🧠 Nancy Brain v0.1.1 - Initial Release

Choose a tag to compare

View all tags
@AmberLee2427 AmberLee2427 released this 24 Aug 18:36
· 160 commits to main since this release
v0.1.1
b6d49e4

Turn any GitHub repository into a searchable knowledge base for AI agents.

We're excited to introduce Nancy Brain - a powerful tool that transforms GitHub repositories into intelligent, searchable knowledge bases that AI assistants can instantly access and understand.

🚀 What is Nancy Brain?

Nancy Brain bridges the gap between AI assistants and the vast knowledge stored in GitHub repositories. Instead of AI agents struggling with incomplete or outdated information, they now have direct access to:

  • Complete source code - Python classes, methods, and implementation details
  • Live documentation - Tutorials, API docs, and usage examples
  • Real-world examples - Jupyter notebooks, test cases, and configuration files
  • Smart weighting system - Boost important documents with learning that persists

✨ Key Features

🔍 Intelligent Search

  • Semantic search across entire repositories
  • Vector embeddings for context-aware results
  • Support for code, documentation, and notebooks

🛠️ Easy Integration

  • Simple CLI for repository management
  • HTTP API for AI agent integration
  • Model Context Protocol (MCP) server support

📊 Smart Knowledge Management

  • Automatic repository cloning and processing
  • Configurable document weighting
  • Persistent learning across sessions

🔌 Multiple Interfaces

  • Command-line interface for direct use
  • REST API for programmatic access
  • MCP server for Claude Desktop integration

🎯 Perfect For

  • AI Researchers working with machine learning libraries
  • Developers building AI-powered applications
  • Data Scientists exploring new tools and frameworks
  • Anyone who wants their AI assistant to truly understand their codebase

🚀 Quick Start

# Install nancy-brain
pip install nancy-brain

# Initialize a new project
nancy-brain init my-ai-project
cd my-ai-project

# Add repositories you want to search
nancy-brain add-repo https://github.com/scikit-learn/scikit-learn.git
nancy-brain add-repo https://github.com/pytorch/pytorch.git

# Build the knowledge base
nancy-brain build

# Start searching!
nancy-brain search "how to train a neural network"

🔧 What's Included

  • Core RAG Engine - Powered by txtai for fast, accurate search
  • Repository Management - Clone, update, and organize GitHub repos
  • Multiple APIs - CLI, HTTP REST, and MCP server interfaces
  • Configuration System - Flexible YAML-based setup
  • Admin UI - Web interface for knowledge base management
  • Comprehensive Testing - 94 tests ensuring reliability across Python 3.10+

🌟 Example Use Cases

For Machine Learning:

nancy-brain search "MulensModel microlensing light curve fitting"
# Returns actual code examples from astronomy packages

For Web Development:

nancy-brain search "FastAPI dependency injection patterns"
# Shows real implementation details from FastAPI repos

For Data Science:

nancy-brain search "pandas dataframe optimization techniques"
# Finds performance tips from pandas documentation and examples

🔮 Coming Soon

  • Support for more repository types (GitLab, Bitbucket)
  • Advanced filtering and search operators
  • Integration with more AI platforms
  • Collaborative knowledge sharing features

📖 Learn More

  • Documentation: Full setup and usage guides included
  • Examples: Sample configurations for popular ML libraries
  • API Reference: Complete HTTP and MCP API documentation

🙏 Thank You

This initial release represents months of development focused on making AI assistants truly understand the code and documentation they work with. We're excited to see what you build with Nancy Brain!

Install now: pip install nancy-brain

Repository: https://github.com/AmberLee2427/nancy-brain

License: MIT

Assets 2
Loading