Dama12 commited on
Commit
0f82d71
Β·
1 Parent(s): ee33562

docs: update README with OpenAlex, Semantic Memory, and History features

Browse files
Files changed (1) hide show
  1. README.md +40 -47
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 reasoning models and sophisticated orchestration.
16
 
17
  ---
18
 
19
  ## πŸš€ Key Features
20
 
21
- ### πŸ” 1. Contradiction Detection
22
- - Analyzes semantic meaning across multiple documents.
23
- - Identifies conflicting findings or methodologies humans might overlook.
24
- - Provides confidence scoring for each detected contradiction.
25
 
26
- ### πŸ’‘ 2. Hypothesis Generation
27
- - Synthesizes knowledge from disparate sources to propose novel research directions.
28
- - Suggests unexplored intersections between different scientific fields.
 
29
 
30
- ### πŸ“‹ 3. Protocol Design
31
- - Generates rigorous, step-by-step experimental protocols.
32
- - Identifies potential risks and suggests mitigation strategies.
33
- - Optimizes resource allocation for more efficient research.
34
 
35
- ### πŸ›‘οΈ 4. Self-Consistency Layer
36
- - Employs a multi-step reasoning process (orchestrated via LangGraph).
37
- - Generates multiple versions of analysis and independently evaluates them.
38
- - Selects the most robust and consistent findings for the final report.
39
 
40
- ### πŸ“œ 5. Full Audit Trail
41
- - Every decision and reasoning step is logged for transparency.
42
- - Ensures reproducibility, a cornerstone of scientific integrity.
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 modern, high-performance stack designed for scalability and reliability:
54
 
55
  ```mermaid
56
  graph TD
57
  A[Frontend: Next.js] --> B[API: FastAPI]
58
- B --> C[Orchestrator: LangGraph]
59
- C --> D[Reasoning Engine: K2 Think V2 / LLMs]
60
- D --> E[Vector DB: Qdrant]
61
  D --> F[Relational DB: PostgreSQL / Supabase]
62
- C --> G[Task Queue: Celery + Redis]
 
63
  ```
64
 
65
  ### Tech Stack
66
  - **Backend:** [FastAPI](https://fastapi.tiangolo.com/) (Python)
67
- - **Orchestration:** [LangGraph](https://www.langchain.com/langgraph)
68
- - **Vector Search:** [Qdrant](https://qdrant.tech/) (Semantic similarity)
69
- - **Relational Database:** [PostgreSQL](https://www.postgresql.org/) ([Supabase](https://supabase.com/))
70
- - **Cache/Broker:** [Redis](https://redis.io/) ([Upstash](https://upstash.com/))
71
  - **Containerization:** [Docker](https://www.docker.com/)
72
- - **Hosting / Deployment:** **[Hugging Face Spaces](https://huggingface.co/spaces)**
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 for deep reasoning.
90
- - `QDRANT_URL` & `QDRANT_API_KEY`: Connectivity to Qdrant.
91
- - `CELERY_BROKER_URL`: Upstash Redis URL.
 
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**.