| --- |
| title: PaperCircle Papers API |
| emoji: 📄 |
| colorFrom: blue |
| colorTo: purple |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| license: mit |
| short_description: Paper circle offline database |
| --- |
| |
| # PaperCircle Papers API |
|
|
| FastAPI service serving conference papers from a Parquet dataset via DuckDB. |
| Provides full-text search and filtered browsing for 230K+ academic papers. |
|
|
| ## Environment Variables |
|
|
| - `HF_DATASET_REPO`: HuggingFace dataset repo ID (default: `ItsMaxNorm/pc-database`) |
| - `PARQUET_PATH`: Local path to papers.parquet (alternative to HF download) |
|
|
| ## Endpoints |
|
|
| - `GET /health` — Health check |
| - `GET /api/community/papers` — Paginated papers with filters |
| - `GET /api/community/papers/{paper_id}` — Single paper |
| - `GET /api/community/filters` — Filter options |
| - `GET /api/search?query=...` — Full-text search |
|
|
