Skip to content

Godwin-T/Lumora

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 

Repository files navigation

Lumora: Tax and Business Awareness Platform for Nigerian Businesses

Project Overview

This platform is designed to educate Nigerian business owners and individuals about tax laws and business regulations. By providing accurate, accessible information, we aim to reduce ignorance, ensure compliance, and help users avoid penalties.

Objective

  • Empower users with knowledge about Nigerian tax laws and business regulations.
  • Promote compliance and smooth business operations.
  • Reduce the risk of penalties due to ignorance.

Approach

  1. Data Collection: Information sourced from reliable government agencies such as CAC, FIRS, and other official platforms.
  2. System Development: Built a robust front-end and back-end to process and deliver tax-related information.
  3. API Integration: Initially integrated Germinal API; switched to Open API for improved reliability.

Current Status

  • Ongoing development with continuous enhancements.
  • Functional chat interface for user queries.
  • Multilingual support for broader accessibility.
  • Premium user identification system implemented.
  • Planned feature: Premium users will be able to upload documents/data for personalized insights and chat interactions (not yet implemented).

Impact

The platform empowers businesses and individuals with essential knowledge, fostering compliance and smoother operations within Nigeria's regulatory environment.


Platform Features

  • Chat Interface: Users can ask questions and receive answers based on curated data.
  • Multilingual Support: Interact in multiple languages for better accessibility.
  • Premium User System: Premium users enjoy enhanced features and identification.
  • Future Feature: Document/data upload for premium users to receive tailored insights (coming soon).

Project Structure

lumora/
├── client/   # Frontend application (React)
├── backend/  # Backend API and services
└── README.md # Project documentation

Backend

  • Purpose: Handles data processing, user management, chat logic, and API integrations.
  • Technologies: Python, FastAPI, LangChain, Pinecone
  • Features:
    • API endpoints for chat and data queries
    • User authentication and premium identification
    • Multilingual support logic
    • Integration with external tax data sources

Refer to /backend/README.md for detailed backend setup and usage.


Client

  • Purpose: Provides the user interface for interacting with the platform.
  • Technologies: React, Vite, Axios
  • Features:
    • Responsive chat interface
    • Multilingual UI
    • Premium user experience
    • Easy navigation and access to tax information

Refer to /client/README.md for detailed client setup and usage.


Getting Started

  1. Clone the repository:
    git clone https://github.com/Godwin-T/lumora.git
  2. Follow setup instructions in the respective client and backend directories.

Live Link

You can access the live platform here: Lumora Live Platform

License

This project is licensed under the MIT License.


For questions or contributions, please contact the project maintainers.


Data Sources and Citations

The platform utilizes information from the following official sources:

Tax Information Sources

  1. FIRS - Simplifying Tax, Maximizing Revenue
  2. Yearly CbC Notification Form
  3. Guidelines for Country-by-Country Reporting in Nigeria
  4. Guidelines on the Appropriate Use of CbC Reports
  5. Public Notice on the Submission of Notification Pursuant to regulation of the CbC Regulations
  6. FIRS Public Notice on CbCR
  7. Nigerian Government Gazette dated 2018-01-08 No. 2
  8. FIRS Issues Two Circulars - May 2024
  9. FIRS Issues Circular on the Implementation of Deduction of Tax at Source
  10. Types Of Taxes In Nigeria - Cowrywise Blog
  11. Taxes You Should Know As A Nigerian Business Owner - Advans Lafayette Microfinance Bank

Business Registration and Setup Information

  1. What You Need To Start A Business In Nigeria: The Complete 2025 Registration Checklist - Corporate Bestie
  2. Guide to Company & Business Registration in Nigeria - Bumpa Business Academy
  3. How to Start a Business in Nigeria (2025 Legal Guide for First-Time Founders) - Goidara
  4. CAC Registration Requirements for Business Name and Company
  5. How to Register a Business Name in Nigeria: 7 Ways - PressOne Africa

About

Tax and Business Awareness Platform for Nigerian Businesses

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •