Skip to content

TruthMatrix is an AI-powered web app that provides unbiased answers to your questions by analyzing information from credible sources.

Notifications You must be signed in to change notification settings

Darkbucher/Truth-Matrix

Repository files navigation

TruthMatrix 🌟

TruthMatrix Logo License TypeScript React Express

A modern full-stack web application for unbiased information synthesis

Watch the video

✨ Features

Frontend Backend AI & Security
🚀 Modern React with TypeScript ⚡ Express.js Server 🤖 Google AI Integration
🎨 Tailwind CSS & Radix UI 🔒 Passport Authentication 🔄 Real-time WebSocket
📱 Responsive Design 💾 In-memory Session Management 📊 Data Visualization

🛠️ Tech Stack

Frontend

  • React 18 - Latest features and concurrent rendering
  • TypeScript - Type-safe development
  • Tailwind CSS - Utility-first styling
  • Radix UI - Accessible component primitives
  • React Query - Powerful data fetching
  • Wouter - Lightweight routing

Backend

  • Express.js - Fast, unopinionated web framework
  • TypeScript - Type-safe backend development
  • Passport.js - Authentication middleware
  • WebSocket - Real-time communication
  • In-memory Storage - Session management

🚀 Quick Start

  1. Clone the repository

    git clone [repository-url]
    cd TruthMatrix
  2. Install dependencies

    npm install
  3. Environment Setup Create a .env file in the root directory:

    SESSION_SECRET=your_session_secret
    GOOGLE_AI_API_KEY=your_google_ai_api_key
  4. Start Development

    npm run dev

📁 Project Structure

TruthMatrix/
├── client/         # Frontend React application
│   ├── src/       # Source files
│   ├── public/    # Static assets
│   └── tests/     # Frontend tests
├── server/         # Backend Express application
│   ├── src/       # Source files
│   ├── routes/    # API routes
│   └── tests/     # Backend tests
├── shared/         # Shared types and utilities
├── attached_assets/# Static assets
└── .config/        # Configuration files

🎯 Core Functionality

TruthMatrix is designed to provide unbiased information synthesis through:

  1. Credible Source Integration

    • Curated list of trusted information sources
    • Direct question answering capability
    • Keyword-based information retrieval
  2. AI-Powered Analysis

    • Intelligent information synthesis
    • Fact-based summarization
    • Transparent source attribution
  3. User Experience

    • Clean, intuitive interface
    • Real-time updates
    • Responsive design for all devices

📝 Available Scripts

Command Description
npm run dev Start development server
npm run build Build for production
npm run start Start production server
npm run check Type check
npm run test Run tests

🤝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Important Note

This version uses in-memory storage for session management and temporary data. All data is cleared on server restart.


Made with ❤️ by Adarsh (DarkBucher)

GitHub stars GitHub forks

About

TruthMatrix is an AI-powered web app that provides unbiased answers to your questions by analyzing information from credible sources.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages