AI-Powered Medical Diagnosis Platform
NEURAXIS is a cutting-edge medical diagnosis platform that leverages artificial intelligence to assist healthcare professionals in making accurate, timely diagnoses. Built as a modern monorepo, it combines the power of Next.js for a responsive frontend with FastAPI-powered AI services on the backend.
- 🔬 AI-Powered Diagnostics - Advanced ML models for medical image analysis and symptom assessment
- 🏥 HIPAA Compliant - Enterprise-grade security and audit logging
- ⚡ Real-time Updates - WebSocket-based live notifications and updates
- 📊 Analytics Dashboard - Comprehensive insights and reporting
- 🔐 Multi-tenant Architecture - Support for multiple healthcare organizations
neuraxis/
├── apps/
│ ├── web/ # Next.js 15 Frontend
│ └── docs/ # Documentation site
├── packages/
│ ├── ui/ # Shared React components
│ ├── shared-types/ # TypeScript type definitions
│ ├── utils/ # Common utilities
│ └── config/ # Shared configurations
├── services/
│ └── ai-service/ # FastAPI AI/ML service
├── docker/ # Docker configurations
└── infrastructure/ # IaC and deployment configs
- Node.js >= 18.0.0
- Python >= 3.11
- Docker & Docker Compose
- pnpm or npm >= 9.0.0
-
Clone the repository
git clone https://github.com/your-org/neuraxis.git cd neuraxis -
Install dependencies
npm install
-
Set up environment variables
cp .env.example .env # Edit .env with your configuration -
Start infrastructure services
npm run docker:up
-
Run development servers
npm run dev
| Service | URL |
|---|---|
| Frontend | http://localhost:3000 |
| API Docs | http://localhost:8000/docs |
| pgAdmin | http://localhost:5050 |
| Redis Commander | http://localhost:8081 |
| Package | Description |
|---|---|
@neuraxis/web |
Main Next.js 15 frontend application |
@neuraxis/docs |
Documentation and API reference site |
| Package | Description |
|---|---|
@neuraxis/ui |
Shared React component library |
@neuraxis/shared-types |
TypeScript types and interfaces |
@neuraxis/utils |
Common utility functions |
@neuraxis/config |
Shared ESLint, TypeScript, Tailwind configs |
| Package | Description |
|---|---|
ai-service |
FastAPI backend for AI/ML processing |
# Development
npm run dev # Start all services in development mode
npm run build # Build all packages
npm run lint # Lint all packages
npm run test # Run all tests
npm run type-check # TypeScript type checking
# Docker
npm run docker:up # Start infrastructure services
npm run docker:down # Stop infrastructure services
npm run docker:logs # View service logs
# Database
npm run db:migrate # Run database migrations
npm run db:seed # Seed database with sample data
# Formatting
npm run format # Format all files with Prettier
npm run format:check # Check formatting without changes# Run a specific task
npx turbo run build --filter=@neuraxis/web
# Run with verbose output
npx turbo run dev --verbosity=2
# Generate dependency graph
npx turbo run build --graph# Start all services
docker-compose up -d
# Start with optional tools (pgAdmin, Redis Commander)
docker-compose --profile tools up -d
# Start with S3-compatible storage (MinIO)
docker-compose --profile storage up -d
# View logs
docker-compose logs -f backend| Profile | Services Included |
|---|---|
| (default) | postgres, redis, frontend, backend |
| tools | + pgAdmin, Redis Commander |
| storage | + MinIO |
NEURAXIS is designed with healthcare compliance in mind:
- HIPAA Compliance - Audit logging, data encryption, access controls
- SOC 2 Ready - Security best practices implemented
- Data Encryption - At-rest and in-transit encryption
- Role-Based Access Control - Fine-grained permissions
We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is proprietary software. All rights reserved.
Built with ❤️ by the NEURAXIS Team
Transforming Healthcare with AI