Spaces:
Running
Running
docs: update README with OpenAlex, Semantic Memory, and History features
Browse files
README.md
CHANGED
|
@@ -10,88 +10,81 @@ pinned: false
|
|
| 10 |
|
| 11 |
# π§ͺ AI Scientific Co-Investigator: Deep Reasoning for Research
|
| 12 |
|
| 13 |
-
**Detect research contradictions, generate novel hypotheses, and design rigorous protocols using deep reasoning.**
|
| 14 |
|
| 15 |
-
Scientific research is often hindered by the massive volume of existing literature. Researchers spend up to 60% of their time searching for contradictions, identifying gaps, and designing experiments. **AI Scientific Co-Investigator** automates this pipeline using advanced
|
| 16 |
|
| 17 |
---
|
| 18 |
|
| 19 |
## π Key Features
|
| 20 |
|
| 21 |
-
###
|
| 22 |
-
-
|
| 23 |
-
-
|
| 24 |
-
-
|
| 25 |
|
| 26 |
-
###
|
| 27 |
-
-
|
| 28 |
-
-
|
|
|
|
| 29 |
|
| 30 |
-
###
|
| 31 |
-
-
|
| 32 |
-
-
|
| 33 |
-
-
|
| 34 |
|
| 35 |
-
###
|
| 36 |
-
-
|
| 37 |
-
-
|
| 38 |
-
-
|
| 39 |
|
| 40 |
-
###
|
| 41 |
-
-
|
| 42 |
-
-
|
| 43 |
-
|
| 44 |
-
### π 6. Real-Time Literature Search
|
| 45 |
-
- Seamless integration with the **ArXiv API**.
|
| 46 |
-
- Fetch and analyze the latest scientific papers in real-time.
|
| 47 |
-
- Automatically incorporate live research data into the deep reasoning pipeline.
|
| 48 |
|
| 49 |
---
|
| 50 |
|
| 51 |
## π οΈ Technical Architecture
|
| 52 |
|
| 53 |
-
The platform uses a
|
| 54 |
|
| 55 |
```mermaid
|
| 56 |
graph TD
|
| 57 |
A[Frontend: Next.js] --> B[API: FastAPI]
|
| 58 |
-
B --> C[Orchestrator:
|
| 59 |
-
C --> D[Reasoning Engine: K2 Think V2
|
| 60 |
-
D --> E[
|
| 61 |
D --> F[Relational DB: PostgreSQL / Supabase]
|
| 62 |
-
C --> G[
|
|
|
|
| 63 |
```
|
| 64 |
|
| 65 |
### Tech Stack
|
| 66 |
- **Backend:** [FastAPI](https://fastapi.tiangolo.com/) (Python)
|
| 67 |
-
- **
|
| 68 |
-
- **Vector
|
| 69 |
-
- **
|
| 70 |
-
- **
|
| 71 |
- **Containerization:** [Docker](https://www.docker.com/)
|
| 72 |
-
- **Hosting
|
| 73 |
|
| 74 |
---
|
| 75 |
|
| 76 |
-
## βοΈ Deployment
|
| 77 |
-
|
| 78 |
-
This backend is fully containerized and currently **deployed on Hugging Face Spaces** for robust, scalable hosting.
|
| 79 |
-
|
| 80 |
-
### Prerequisites
|
| 81 |
-
- **Supabase**: Relational Database setup.
|
| 82 |
-
- **Qdrant Cloud**: Vector Database instance.
|
| 83 |
-
- **Upstash**: Redis instance for Celery tasks.
|
| 84 |
|
| 85 |
### Environment Variables
|
| 86 |
-
The following secrets are required:
|
| 87 |
- `DATABASE_URL`: Supabase connection string.
|
| 88 |
- `SECRET_KEY`: Secure random string for JWT.
|
| 89 |
-
- `K2_THINK_API_KEY`: K2 Think V2 API key
|
| 90 |
-
- `
|
| 91 |
-
- `
|
|
|
|
| 92 |
|
| 93 |
---
|
| 94 |
|
| 95 |
## π Ownership & License
|
| 96 |
|
| 97 |
This project is the intellectual property of **[Soumana Dama](https://www.linkedin.com/in/soumana-dama-445096253/)** ([GitHub Profile](https://github.com/Damasoumana1)). All rights reserved.
|
|
|
|
|
|
| 10 |
|
| 11 |
# π§ͺ AI Scientific Co-Investigator: Deep Reasoning for Research
|
| 12 |
|
| 13 |
+
**Detect research contradictions, generate novel hypotheses, and design rigorous protocols using deep reasoning and persistent semantic memory.**
|
| 14 |
|
| 15 |
+
Scientific research is often hindered by the massive volume of existing literature. Researchers spend up to 60% of their time searching for contradictions, identifying gaps, and designing experiments. **AI Scientific Co-Investigator** automates this pipeline using the advanced **K2 Think V2 Engine** and sophisticated semantic orchestration.
|
| 16 |
|
| 17 |
---
|
| 18 |
|
| 19 |
## π Key Features
|
| 20 |
|
| 21 |
+
### π§ 1. Long-Term Semantic Memory (New!)
|
| 22 |
+
- **Cross-Analysis Persistence:** The agent remembers past findings, user preferences, and methodological choices across different projects.
|
| 23 |
+
- **Semantic Retrieval:** Automatically queries past research context from **Qdrant** to enrich new analyses.
|
| 24 |
+
- **Knowledge Consolidation:** Every analysis is automatically summarized and "learned" by your co-investigator.
|
| 25 |
|
| 26 |
+
### π 2. Multi-Source Discovery Sync
|
| 27 |
+
- **200M+ Articles:** Real-time integration with **ArXiv, PubMed, DOAJ, and OpenAlex**.
|
| 28 |
+
- **Unified Search:** Search across all major scientific databases from a single interface.
|
| 29 |
+
- **Citation Intelligence:** Displays citation counts and impact metrics directly in search results.
|
| 30 |
|
| 31 |
+
### π 3. Contradiction Detection
|
| 32 |
+
- **Multi-Document Reasoning:** Analyzes semantic meaning across multiple PDFs/Articles.
|
| 33 |
+
- **Conflict Identification:** Flags where Paper A disagrees with Paper B on findings or metrics.
|
| 34 |
+
- **Resolution Paths:** Suggests how to resolve scientific conflicts through new experiments.
|
| 35 |
|
| 36 |
+
### π 4. Protocol Design & Optimization
|
| 37 |
+
- **Step-by-Step Synthesis:** Generates complete experimental protocols from scratch.
|
| 38 |
+
- **Resource Aware:** Optimizes plans for hardware (NVIDIA GPUs), budget, and time constraints.
|
| 39 |
+
- **Risk Audit:** Identifies safety/ethics risks and suggests mitigation strategies.
|
| 40 |
|
| 41 |
+
### π‘οΈ 5. Ethical & Rigorous Auditing
|
| 42 |
+
- **Clinical Rigor:** Built-in checks for clinical safety and academic integrity.
|
| 43 |
+
- **Reasoning Traces:** Full "Chain of Thought" visibility for every AI decision.
|
| 44 |
+
- **Grant-Ready Exports:** Export findings directly to **LaTeX** for grant proposals.
|
|
|
|
|
|
|
|
|
|
|
|
|
| 45 |
|
| 46 |
---
|
| 47 |
|
| 48 |
## π οΈ Technical Architecture
|
| 49 |
|
| 50 |
+
The platform uses a state-of-the-art stack designed for "Scientific Reasoning" depth:
|
| 51 |
|
| 52 |
```mermaid
|
| 53 |
graph TD
|
| 54 |
A[Frontend: Next.js] --> B[API: FastAPI]
|
| 55 |
+
B --> C[Orchestrator: K2 Logic]
|
| 56 |
+
C --> D[Reasoning Engine: K2 Think V2]
|
| 57 |
+
D --> E[Semantic Memory: Qdrant Vector DB]
|
| 58 |
D --> F[Relational DB: PostgreSQL / Supabase]
|
| 59 |
+
C --> G[Global Discovery: OpenAlex/PubMed/ArXiv]
|
| 60 |
+
D --> H[Export: LaTeX / CSV / PDF]
|
| 61 |
```
|
| 62 |
|
| 63 |
### Tech Stack
|
| 64 |
- **Backend:** [FastAPI](https://fastapi.tiangolo.com/) (Python)
|
| 65 |
+
- **AI Core:** **K2 Think V2** (Deep Reasoning API)
|
| 66 |
+
- **Vector Intelligence:** [Qdrant](https://qdrant.tech/) (Semantic Memory & RAG)
|
| 67 |
+
- **Database:** [PostgreSQL](https://www.postgresql.org/) ([Supabase](https://supabase.com/))
|
| 68 |
+
- **Discovery APIs:** OpenAlex, PubMed, ArXiv, DOAJ
|
| 69 |
- **Containerization:** [Docker](https://www.docker.com/)
|
| 70 |
+
- **Hosting:** **[Hugging Face Spaces](https://huggingface.co/spaces)**
|
| 71 |
|
| 72 |
---
|
| 73 |
|
| 74 |
+
## βοΈ Deployment & Config
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 75 |
|
| 76 |
### Environment Variables
|
| 77 |
+
The following secrets are required on Hugging Face Spaces:
|
| 78 |
- `DATABASE_URL`: Supabase connection string.
|
| 79 |
- `SECRET_KEY`: Secure random string for JWT.
|
| 80 |
+
- `K2_THINK_API_KEY`: K2 Think V2 API key.
|
| 81 |
+
- `VECTOR_DB_URL` & `VECTOR_DB_API_KEY`: Connectivity to Qdrant Cloud.
|
| 82 |
+
- `OPENAI_API_KEY`: For semantic embeddings.
|
| 83 |
+
- `FRONTEND_URL`: For OAuth redirect synchronization.
|
| 84 |
|
| 85 |
---
|
| 86 |
|
| 87 |
## π Ownership & License
|
| 88 |
|
| 89 |
This project is the intellectual property of **[Soumana Dama](https://www.linkedin.com/in/soumana-dama-445096253/)** ([GitHub Profile](https://github.com/Damasoumana1)). All rights reserved.
|
| 90 |
+
Developed for the **AI Scientific Innovation Hackathon**.
|