527adec599
- Remove MIT License - Add proprietary license with All Rights Reserved - Update README with ⚖️ Licenza e Note Legali section - Specify Luca Sacchi Ricciardi as copyright holder - Designate Foro di Milano as exclusive jurisdiction ⚖️ All Rights Reserved - Luca Sacchi Ricciardi 2026
181 lines
5.0 KiB
Markdown
181 lines
5.0 KiB
Markdown
# NotebookLM Agent API
|
|
|
|
[](https://www.python.org/downloads/)
|
|
[](https://fastapi.tiangolo.com/)
|
|
[](https://github.com/astral-sh/ruff)
|
|
[](https://docs.pytest.org/)
|
|
|
|
> **API e Webhook Interface per Google NotebookLM Automation**
|
|
|
|
Questo progetto fornisce un'interfaccia API REST completa per Google NotebookLM, con supporto webhook per integrazione con altri agenti AI. Sviluppato seguendo le metodologie **Spec-Driven Development (SDD)** e **Test Driven Development (TDD)**.
|
|
|
|
## Caratteristiche
|
|
|
|
- **API REST Completa**: Gestione notebook, fonti, chat, generazione contenuti
|
|
- **Webhook System**: Notifiche event-driven per integrazione multi-agent
|
|
- **AI Skill**: Interfaccia nativa per OpenCode e altri agenti AI
|
|
- **Qualità del Codice**: ≥90% test coverage, type hints, linting
|
|
- **Metodologie**: SDD + TDD + Conventional Commits
|
|
|
|
## Requisiti
|
|
|
|
- Python 3.10+
|
|
- [uv](https://github.com/astral-sh/uv) per dependency management
|
|
- Account Google con accesso a NotebookLM
|
|
|
|
## Installazione
|
|
|
|
```bash
|
|
# Clona il repository
|
|
git clone https://github.com/example/notebooklm-agent.git
|
|
cd notebooklm-agent
|
|
|
|
# Crea virtual environment
|
|
uv venv --python 3.10
|
|
source .venv/bin/activate
|
|
|
|
# Installa dipendenze
|
|
uv sync --extra dev --extra browser
|
|
|
|
# Installa pre-commit hooks
|
|
uv run pre-commit install
|
|
|
|
# Configura ambiente
|
|
cp .env.example .env
|
|
# Modifica .env con le tue configurazioni
|
|
```
|
|
|
|
## Configurazione
|
|
|
|
Crea un file `.env`:
|
|
|
|
```env
|
|
# API Configuration
|
|
NOTEBOOKLM_AGENT_API_KEY=your-api-key
|
|
NOTEBOOKLM_AGENT_WEBHOOK_SECRET=your-webhook-secret
|
|
NOTEBOOKLM_AGENT_PORT=8000
|
|
NOTEBOOKLM_AGENT_HOST=0.0.0.0
|
|
|
|
# NotebookLM Configuration
|
|
NOTEBOOKLM_HOME=~/.notebooklm
|
|
NOTEBOOKLM_PROFILE=default
|
|
|
|
# Logging
|
|
LOG_LEVEL=INFO
|
|
LOG_FORMAT=json
|
|
```
|
|
|
|
## Autenticazione NotebookLM
|
|
|
|
```bash
|
|
# Login a NotebookLM (prima volta)
|
|
notebooklm login
|
|
|
|
# Verifica autenticazione
|
|
notebooklm auth check
|
|
```
|
|
|
|
## Avvio
|
|
|
|
```bash
|
|
# Development server
|
|
uv run fastapi dev src/notebooklm_agent/api/main.py
|
|
|
|
# Production server
|
|
uv run gunicorn notebooklm_agent.api.main:app -w 4 -k uvicorn.workers.UvicornWorker
|
|
```
|
|
|
|
L'API sarà disponibile su `http://localhost:8000`
|
|
|
|
- API docs: `http://localhost:8000/docs`
|
|
- OpenAPI schema: `http://localhost:8000/openapi.json`
|
|
|
|
## Uso Rapido
|
|
|
|
```bash
|
|
# Creare notebook
|
|
curl -X POST http://localhost:8000/api/v1/notebooks \
|
|
-H "X-API-Key: your-key" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"title": "Ricerca AI"}'
|
|
|
|
# Aggiungere fonte
|
|
curl -X POST http://localhost:8000/api/v1/notebooks/{id}/sources \
|
|
-H "X-API-Key: your-key" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"type": "url", "url": "https://example.com"}'
|
|
|
|
# Generare podcast
|
|
curl -X POST http://localhost:8000/api/v1/notebooks/{id}/generate/audio \
|
|
-H "X-API-Key: your-key" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"instructions": "Make it engaging"}'
|
|
```
|
|
|
|
## Testing
|
|
|
|
```bash
|
|
# Esegui tutti i test
|
|
uv run pytest
|
|
|
|
# Con coverage
|
|
uv run pytest --cov=src/notebooklm_agent --cov-report=term-missing
|
|
|
|
# Solo unit test
|
|
uv run pytest tests/unit/ -m unit
|
|
|
|
# Solo integration test
|
|
uv run pytest tests/integration/ -m integration
|
|
```
|
|
|
|
## Sviluppo
|
|
|
|
### Workflow
|
|
|
|
1. **Spec-Driven**: Definisci requisiti in `prd.md`
|
|
2. **TDD**: Scrivi test → Implementa → Refactor
|
|
3. **Conventional Commits**: Segui lo standard per i commit
|
|
4. **Pre-commit**: I controlli automatici garantiscono qualità
|
|
|
|
### Struttura Progetto
|
|
|
|
```
|
|
notebooklm-agent/
|
|
├── src/notebooklm_agent/ # Codice sorgente
|
|
├── tests/ # Test suite
|
|
├── docs/ # Documentazione
|
|
├── prd.md # Product Requirements
|
|
├── AGENTS.md # Linee guida OpenCode
|
|
├── SKILL.md # Definizione skill AI
|
|
└── CONTRIBUTING.md # Guida contribuzione
|
|
```
|
|
|
|
## Documentazione
|
|
|
|
- [PRD](./prd.md) - Product Requirements Document
|
|
- [AGENTS.md](./AGENTS.md) - Linee guida per OpenCode
|
|
- [SKILL.md](./SKILL.md) - Skill per agenti AI
|
|
- [CONTRIBUTING.md](./CONTRIBUTING.md) - Come contribuire
|
|
|
|
## Stato del Progetto
|
|
|
|
⚠️ **Versione Iniziale**: Questo progetto è in fase di setup iniziale. Le funzionalità API sono pianificate per le prossime release.
|
|
|
|
Vedi [CHANGELOG.md](./CHANGELOG.md) per lo stato attuale e la roadmap.
|
|
|
|
## ⚖️ Licenza e Note Legali
|
|
|
|
Questo software è proprietà riservata di Luca Sacchi Ricciardi.
|
|
|
|
Tutti i diritti sono riservati. Per ogni controversia derivante dall'uso o dallo sviluppo di questo software, il foro competente in via esclusiva è il Foro di Milano, Italia.
|
|
|
|
Vedi [LICENSE](./LICENSE) per i termini completi.
|
|
|
|
## Contributing
|
|
|
|
Vedi [CONTRIBUTING.md](./CONTRIBUTING.md) per le linee guida su come contribuire al progetto.
|
|
|
|
---
|
|
|
|
**Nota**: Questo è un progetto non ufficiale e non è affiliato con Google. Usa le API interne di NotebookLM che possono cambiare senza preavviso.
|