open-notebook/docs/index.md
2025-07-17 14:37:14 -03:00

135 lines
No EOL
5.1 KiB
Markdown

# Open Notebook Documentation
Welcome to the complete documentation for Open Notebook - your privacy-focused, AI-powered research companion.
## 🚀 Getting Started
New to Open Notebook? Start here to get up and running quickly.
### 📚 **[Getting Started](getting-started/index.md)**
Everything you need to know to begin your Open Notebook journey.
- **[Introduction](getting-started/introduction.md)** - What is Open Notebook and why use it?
- **[Quick Start](getting-started/quick-start.md)** - Get running in 5 minutes
- **[Installation](getting-started/installation.md)** - Comprehensive setup guide
- **[Your First Notebook](getting-started/first-notebook.md)** - Step-by-step tutorial
---
## 📖 User Guide
Master Open Notebook's interface and core functionality.
### 🎯 **[User Guide](user-guide/index.md)**
Complete reference for using Open Notebook effectively.
- **[Interface Overview](user-guide/interface-overview.md)** - Understanding the layout
- **[Notebooks](user-guide/notebooks.md)** - Organizing your research
- **[Sources](user-guide/sources.md)** - Adding and managing content
- **[Notes](user-guide/notes.md)** - Creating and organizing notes
- **[Chat](user-guide/chat.md)** - Conversing with AI
- **[Search](user-guide/search.md)** - Finding information quickly
---
## ⚡ Features
Explore Open Notebook's advanced capabilities and unique features.
### 🔧 **[Features](features/index.md)**
Deep dives into what makes Open Notebook special.
- **[AI Models](features/ai-models.md)** - Multi-provider AI support
- **[Context Management](features/context-management.md)** - Granular privacy control
- **[Transformations](features/transformations.md)** - Custom content processing
- **[Podcasts](features/podcasts.md)** - Multi-speaker podcast generation
- **[Citations](features/citations.md)** - Research integrity support
- **[REST API](development/api-reference.md)** - [![API Docs](https://img.shields.io/badge/API-Documentation-blue?style=flat-square)](http://localhost:5055/docs) Complete programmatic access
---
## 🚀 Deployment
Set up Open Notebook for different environments and use cases.
### 🐳 **[Deployment](deployment/index.md)**
Complete deployment guides for all scenarios.
- **[Docker](deployment/docker.md)** - Multi-container setup
- **[Single Container](deployment/single-container.md)** - Simplified deployment
- **[Development](deployment/development.md)** - Source code setup
- **[Security](deployment/security.md)** - Production security
---
## 🔧 Development
Technical documentation for developers and contributors.
### 👩‍💻 **[Development](development/index.md)**
Resources for extending and contributing to Open Notebook.
- **[Architecture](development/architecture.md)** - System design overview
- **[API Reference](development/api-reference.md)** - REST API documentation
- **[Contributing](development/contributing.md)** - How to contribute
---
## 🩺 Support
Get help when you need it.
### 🛠️ **[Troubleshooting](troubleshooting/index.md)**
Solutions for common issues and problems.
- **[Common Issues](troubleshooting/common-issues.md)** - Frequent problems and fixes
- **[FAQ](troubleshooting/faq.md)** - Frequently asked questions
- **[Debugging](troubleshooting/debugging.md)** - Advanced troubleshooting
---
## 🔄 Popular Workflows
Common ways to use Open Notebook effectively:
### 🔬 **Academic Research**
Sources → Transformations → Context Management → Citations → Notes
### 📝 **Content Creation**
Sources → AI Models → Transformations → Podcasts → Export
### 🧠 **Learning & Study**
Sources → Search → Notes → Chat → Transformations
### 👥 **Team Research**
Context Management → Citations → Transformations → Sharing
---
## 🌟 What Makes Open Notebook Special
| Feature | Open Notebook | Google Notebook LM | Advantage |
|---------|---------------|-------------------|-----------|
| **Privacy** | Self-hosted | Cloud-only | Complete control |
| **AI Providers** | 15+ providers | Google only | Flexibility |
| **Context Control** | 3 granular levels | All-or-nothing | Privacy & performance |
| **Podcasts** | 1-4 speakers | 2 speakers | Professional quality |
| **Transformations** | Custom & built-in | Limited | Unlimited processing |
| **Citations** | Comprehensive | Basic | Research integrity |
---
## 🆘 Need Help?
- 💬 **[Discord Community](https://discord.gg/37XJPXfz2w)** - Get help and share ideas
- 🐛 **[GitHub Issues](https://github.com/lfnovo/open-notebook/issues)** - Report bugs and request features
- 📧 **[Contact](mailto:luis@lfnovo.com)** - Direct support
- 🌐 **[Website](https://www.open-notebook.ai)** - Project homepage
---
## 🤝 Contributing
Open Notebook is open source and welcomes contributions:
- **[Contributing Guide](development/contributing.md)** - How to get involved
- **[GitHub Repository](https://github.com/lfnovo/open-notebook)** - Source code
- **[License](https://github.com/lfnovo/open-notebook/blob/main/LICENSE)** - MIT License
---
*This documentation is constantly evolving. Found an issue or have a suggestion? Please [open an issue](https://github.com/lfnovo/open-notebook/issues) or contribute directly!*