Back to Projects
UshuariAI

UshuariAI

By Chernet Asmamaw • June 29, 2025

UshuariAI is an intelligent legal assistant platform designed to streamline law inquiries and case management. The system features sophisticated role-based access control and automated case creation capabilities through multiple communication channels.

Features

  • Role-Based Registration: Separate registration and access levels for lawyers, clients, and administrators
  • Multi-Channel Case Creation: Generate cases automatically through phone calls, voicemails, and text interactions
  • AI-Powered Legal Assistant: Intelligent responses to legal inquiries and case management
  • Case Management System: Comprehensive tracking and management of legal cases
  • Voice Processing: Advanced voice-to-text processing for phone and voicemail interactions
  • Client Portal: Dedicated interface for clients to track their cases and communicate
  • Lawyer Dashboard: Professional interface for legal professionals to manage cases and clients
  • Admin Panel: Administrative controls for system management and oversight

Technologies

  • Frontend: React, Next.js, TypeScript, Tailwind CSS
  • Backend: Node.js, Express.js
  • Database: MongoDB/PostgreSQL
  • AI Integration: OpenAI API, Speech-to-Text services
  • Voice Processing: Twilio Voice API, WebRTC
  • Authentication: JWT, Role-based access control
  • Deployment: Vercel/AWS

Getting Started

Clone the repository and install dependencies:

git clone https://github.com/yourusername/ushuari-ai.git
cd ushuari-ai
npm install

Set up environment variables:

# Copy environment template
cp .env.example .env.local

# Add your API keys and configuration
OPENAI_API_KEY=your_openai_key
TWILIO_ACCOUNT_SID=your_twilio_sid
TWILIO_AUTH_TOKEN=your_twilio_token
DATABASE_URL=your_database_url
JWT_SECRET=your_jwt_secret

Run the development server:

npm run dev

The application will be available at http://localhost:3000.

Usage

  1. Registration: Choose your role (lawyer, client, or admin) during registration
  2. Case Creation: Clients can create cases through phone calls, voicemails, or text input
  3. AI Processing: The system processes requests and generates structured case information
  4. Case Assignment: Cases are automatically assigned to appropriate lawyers based on expertise
  5. Communication: Built-in messaging system for client-lawyer communication
  6. Case Tracking: Real-time updates and status tracking for all parties