About Fulusi 📈

Fulusi is a project that aims to build financial awareness on the Tanzania Finance Market with focus on Bank Forex Exchange rates , Stock Markets ( Dar es Salaam Stock Market ), Government Mutual Funds ( UTT AMIS ), Watumishi Housing Fund , Government Bonds and Corporate Bonds. Ideally an information platform that provides live data , shows trend on the growth of foreign currencies , stocks and mutual funds to help Tanzanian citizens to invest.

The Why 🤔💭?

According to the recent Tanzania CENSUS survey , 1% of Tanzanians invest in the stock market compared to 4% in Kenya , the rate is similar in other investment instruments including bonds , mutual funds and foreign exchanges. I believe with this platfom citizens can get live data and monitor how different instruments perform and invest.

Source : Individual Investors' Awareness and Participation in the Dar es Salaam Stock Exchange, Tanzania

The Roadmap 🛣️

• Collecting Live Data
• Building the UI and UX of the platform
• Implementing User Authentication
• visualizing data collected in table format
• Design database to store all scrapped data
• Design APIs to retrieve data from the database
• Collecting and storing data in a database.
• Visualize growth across time (Will need collection for atleast 3 months)
• Able to compare forex prices in banks and suggest the cheapest bank to do exchange.
• Predict how the investment instruments will perform though machine learning models.
• Chatbot that will use both native language swahili and english to provide updates.

How to get started 🚀!

Prerequisites

• Python > 3.8 👉🏾How to download and Install Python
• pip latest version 👉🏾Installing Pip lates Version
• git 👉🏾Download Git
• IDE i.e 👉🏾VS Code

NB

• The project is built on Ubuntu OS ( 24.04 ), but can be run on Windows and MacOs

Steps to get started on Ubuntu 24.04

1. Fork the repository 👉🏾 Click here to Fork !

2. Clone the forked repository to your machine.

git clone https://github.com/<github_username>/Fulusi

3. Navigate to the parent directory.

cd Fulusi

4. Create a virtual environment.

python3 -m venv .venv

5. Activate the virtual environment

source .venv/bin/activate

6. Install python packages from requirements.txt

pip install -r requirements.txt

7. Install PostgreSQL 👉🏾 How to Install PostgreSQL

8. Setting up PostgreSQL in Linux 👉🏾Using PSQL in Linux

9. Create a new database 👉🏾Creating a new database with PSQL

10. Create the user table

flask --app flaskr init-db

11. Create a .env file and copy contents from example.env file and edit with respect to your variables

touch .env && cp example.env .env

12. Run the Flask development server, with debug option and port option

flask --app flaskr run --debug --port 8070

13. Navigate to the "/api/" directory

cd api

14. Run the API server

python3 api.py

15. Hooray 🚀 ! Now the Project is ready and running

How I contribute ?

Please read the contribution guideline

Created By: Alex Mkwizu @genie360s