nancy-brain

https://github.com/amberlee2427/nancy-brain - 🧠 Nancy Brain v0.1.3 - Path Consistency Fix

🐛 Bug Fixes

Fixed embeddings path inconsistency between build and search commands - Both nancy-brain build and nancy-brain search now use the same default embeddings path: embeddings - This aligns with the project structure convention where raw repositories are stored in raw - Users no longer need to manually specify --embeddings-path when using both commands together

🔄 Improved User Experience

Seamless end-to-end workflow ```bash nancy-brain init my-project cd my-project

Edit config/repositories.yml

nancy-brain build # Creates embeddings in knowledgebase/embeddings/ nancy-brain search "query" # Automatically finds embeddings in knowledgebase/embeddings/ ```

📦 Installation

bash pip install --upgrade nancy-brain==0.1.3

🔗 What's Changed

CLI commands now use consistent default paths for better UX
No breaking changes - existing projects will continue to work
Maintains backward compatibility with explicit --embeddings-path usage

This patch ensures a smoother user experience by eliminating the need to manually coordinate paths between the build and search operations.

- Python
Published by AmberLee2427 10 months ago

https://github.com/amberlee2427/nancy-brain - 🧠 Nancy Brain v0.1.1 - Initial Release

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

```bash

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: ```bash nancy-brain search "MulensModel microlensing light curve fitting"

Returns actual code examples from astronomy packages

```

For Web Development: ```bash nancy-brain search "FastAPI dependency injection patterns"

Shows real implementation details from FastAPI repos

```

For Data Science: ```bash 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