Open SourceNewsdesk
    Research systems

    Newsdesk.

    A calm reader for Indian and global market news. The same story from many publishers is shown once, with key points taken from the article.

    View on GitHubRun it on your computer

    What you get

    • One card per event, with a '+N sources' pill instead of ten copies of a headline.
    • Key points picked from the article itself, not written by AI.
    • 500+ NSE companies, each with its own news page.
    • Save, search and mute sources. Your choices stay in your browser.
    Visual Tour

    Inside Newsdesk.

    A look at the main screens of Newsdesk: Today, Stocks, Company pages, Sources and the Reader.

    Today

    Today

    The day's stories, grouped so the same event appears once.

    • Top stories

      Lead story + 'Also making news'

      Each card shows how many publishers covered it (+N sources).

    • In the news

      Company and index chips

      Symbols mentioned most in the last 24 hours, one click to their news.

    View source on GitHub
    Run it

    Run it on your computer.

    Copy, paste, open the link. Nothing is installed outside the project folder.

    You need

    • Node.js 18 or higher
    • Git
    • About 3 minutes
    • Internet (to fetch feeds)
    Open a terminal and run
    git clone https://github.com/MrChartist/newsdesk.git
cd newsdesk
npm install
npm start
    Then open http://localhost:5185 in your browser.
    Prefer step by step?Show
    1. 1Install Node.js 18 or higher (nodejs.org).
    2. 2Clone: git clone https://github.com/MrChartist/newsdesk.git && cd newsdesk
    3. 3Install: npm install
    4. 4Run both frontend and backend: npm start
    5. 5Open http://localhost:5185 for the app. The backend API runs on http://localhost:3001 (check http://localhost:3001/api/health).
    6. 6Run the tests: npm test (checks the SSRF guard, the TextRank summariser, the company mapper and story clustering).
    7. 7For a build: npm run build, then run the backend with npm run backend and serve the dist folder from any static host or reverse proxy.
    Install with AI

    Let an AI install it for you.

    Pick your tool, copy one prompt, paste it. It checks your computer, installs and tells you what to open.

    Claude

    Best when you want architecture explanation, codebase understanding, and a clean implementation plan before edits.

    Repo accessREADME contextTerminal if using Claude Code

    How to use: Paste the prompt with the GitHub link. Ask Claude to read the README, map modules, list risks, and produce a practical plan before using Claude Code or another agent to implement.

    For developers

    Under the hood.

    Best Next Step

    Run npm start, open localhost:5185, read one story in the reader, then ask an AI to trace how feeds become Stories (backend/feedProxy.js and src/lib/stories.ts) before changing anything.

    Open on GitHubBrowse All Projects
    Frequently Asked Questions

    Questions about Newsdesk.

    Answers about how Newsdesk works, where its data comes from, and how to run it yourself.

    Previous

    Commodity Tracker

    Next

    MemVault