Skip to content

Latest commit

Β 

History

History
118 lines (65 loc) Β· 2.48 KB

File metadata and controls

118 lines (65 loc) Β· 2.48 KB

πŸ“š HashPapers

A decentralized platform to upload, verify, and store research papers securely using blockchain (via IPFS & Pinata) with built-in AI-based plagiarism detection.


πŸš€ Features

  • πŸ” Decentralized Storage: Upload papers to IPFS via Pinata
  • πŸ€– AI Plagiarism Detection: Automatically checks paper originality
  • πŸ’Ό Web3 Wallet Integration: Connect using MetaMask
  • 🧠 Smart Search & Filter: Query papers by author, title, tags
  • πŸ”Ž Research Transparency: Publicly accessible, tamper-proof records
  • ⚑ Vite + React + TypeScript: Blazing fast frontend stack

πŸ“¦ Tech Stack

Tech Purpose
Vite Frontend bundler
React UI framework
TypeScript Type safety
Pinata/IPFS Decentralized file storage
OpenAI API AI plagiarism detection

πŸ–₯ Getting Started

1. Clone the repo

git clone https://github.com/your-username/HashPapers.git
cd HashPapers

2. Install dependencies

npm install

3. Configure environment

Create .env file in the root:

VITE_PINATA_API_KEY=your_pinata_key
VITE_PINATA_SECRET_API_KEY=your_pinata_secret
VITE_OPENAI_API_KEY=your_openai_key

4. Run locally

npm run dev


---

πŸ§ͺ How It Works

1. Upload Paper β†’ Sent to IPFS via Pinata API


2. Run AI Plagiarism Check β†’ Uses OpenAI or HuggingFace models


3. Store Metadata β†’ Onchain hash + metadata stored 


4. Explore Papers β†’ Search, view, and verify paper originality




---

πŸ“ Project Structure

src/
β”œβ”€β”€ components/
β”‚   └── ui/           # UI components (e.g., Toaster, Button)
β”‚   └── layout/       # App layout
β”‚   └── providers/    # Context providers (e.g., Web3)
β”œβ”€β”€ routes/           # App routes
β”œβ”€β”€ utils/            # Helper functions (upload to Pinata, etc.)
β”œβ”€β”€ App.tsx           # Main app entry
β”œβ”€β”€ main.tsx          # Root render file


---

πŸ›‘ Security & Trust

πŸ—‚ Papers stored via IPFS: immutable & decentralized

πŸ“œ Hash stored on blockchain: verifiable & tamper-proof

🧠 AI plagiarism check: provides trust and transparency



---

πŸ“„ License

MIT Β© 2025 HashPapers Team


---

🀝 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.


---

πŸ“¬ Contact

Made with ❀ at a hackathon.