think-bigger/README.md
Kade Heyborne 5ede9e2e7e
Initial commit: Phase 1 Dual Manifold Cognitive Architecture
- Complete dual manifold memory system (episodic, semantic, persona layers)
- Braiding engine with structural gates for optimal learning suggestions
- FastAPI backend with comprehensive REST endpoints
- Domain directory templates and configuration system
- Comprehensive planning documentation for 5-phase development
- Integrated UI design specifications for Phase 2
- Fixed linting issues and code quality standards
2025-12-03 16:54:29 -07:00

93 lines
2.5 KiB
Markdown

# Think Bigger - Advanced Second Brain PKM System
A comprehensive Personal Knowledge Management system with AI-powered agents, knowledge graphs, and intelligent content processing.
## Features
- **Multi-Domain Knowledge Organization**: Structured knowledge domains with consistent templates
- **AI Agent Integration**: Dana language runtime for custom automation
- **Knowledge Graphs**: Neo4j-powered relationship mapping
- **Intelligent Search**: Semantic search with embeddings
- **File System Integration**: Real-time monitoring and processing
- **Extensible Architecture**: Plugin system for custom integrations
## Quick Start
1. Install dependencies:
```bash
uv sync
```
2. Set up configuration:
```bash
cp .config/think_bigger/config.json config/local.json
# Edit config/local.json with your settings
```
3. Run the development server:
```bash
uv run uvicorn src.api.main:app --reload
```
## Project Structure
```
think_bigger/
├── src/
│ ├── core/ # Core system components
│ ├── agents/ # AI agent management
│ ├── processing/ # Content processing pipelines
│ ├── api/ # FastAPI application
│ └── ui/ # Frontend components (future)
├── tests/ # Test suite
├── docs/ # Documentation
├── scripts/ # Utility scripts
└── config/ # Configuration files
```
## Development
### Setup
```bash
# Install dependencies
uv sync
# Install pre-commit hooks
uv run pre-commit install
# Run tests
uv run pytest
# Format code
uv run black src/
uv run isort src/
```
### Key Components
- **File Monitor**: Cross-platform file system watching
- **Content Processor**: Document parsing and chunking
- **Embedding Service**: Vector generation for semantic search
- **Knowledge Graph**: Relationship storage and querying
- **Agent Runtime**: Dana language execution environment
## Configuration
The system uses a hierarchical configuration system:
1. `.config/think_bigger/config.json` - Global defaults
2. `config/local.json` - Local overrides
3. Domain-specific configs in each domain's `_meta/` directory
## Contributing
This project follows subagent-driven development principles. Use the appropriate agent for your task:
- `explore`: Codebase analysis and discovery
- `code-task-executor`: Isolated coding tasks
- `testing-agent`: Automated testing
- `documentation-updater`: Documentation maintenance
## License
MIT License - see LICENSE file for details.