Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peggun/osd
Open-Source Data for everyone to use freely. Built upon the Flask framework in Python
https://github.com/peggun/osd
api data database flask python3 sqlite website
Last synced: 5 days ago
JSON representation
Open-Source Data for everyone to use freely. Built upon the Flask framework in Python
- Host: GitHub
- URL: https://github.com/peggun/osd
- Owner: Peggun
- License: apache-2.0
- Created: 2024-08-08T09:44:46.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-08-27T14:19:23.000Z (3 months ago)
- Last Synced: 2024-08-27T16:43:55.151Z (3 months ago)
- Topics: api, data, database, flask, python3, sqlite, website
- Language: Python
- Homepage:
- Size: 557 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# osd (Open-Source Data)
As a programmer myself, I have noticed when training AI's, I have to scour the internet for a file size that fits my recommended size. But here at osd, you can have all sorts of data, for free anywhere to use. This is the Australian version, and I plan to introduce different countries to this project. osd has everything, from books, to datasets, to wiki pages. (some of which are still coming)
### DISCLAIMER: ALL FILES THAT ARE TO BE DOWNLOADED ALL FOLLOW THE [AUSTRALIAN COPYRIGHT LAW](https://www.alrc.gov.au/publication/genes-and-ingenuity-gene-patenting-and-human-health-alrc-report-99/28-copyright-and-databases/copyright-law/) AND [AUSTRALIAN PUBLIC DOMAIN](https://www.nla.gov.au/stories/news/2024/public-domain-2024). IF YOU ARE BASED OUTSIDE OF AUSTRALIA, YOU ARE RISKING GRAVE CONSEQUENCES BY DOWNLOADING DATA. PLEASE CHECK THE COPYRIGHT LAWS AND PUBLIC DOMAIN LAWS IN YOUR COUNTRY TO ENSURE YOU ARE UNDER THE LAW. WE ARE NOT AT FAULT FOR PEOPLE DOWNLOADING DATA FROM OUTSIDE AUSTRALIA. HOWEVER, THERE ARE SOME DATA THAT YOU CAN DOWNLOAD, BESIDE EBOOKS AND MORE THAT ARE COPYRIGHTED. PLEASE CONTINUE AT YOUR OWN RISK.
If you are based outside of Australia, you are welcome to download and contribute different data by opening an issue and welcomed to try out some ideas you have in mind
Here are the steps to download and contribute to the project.
# 1. Prequistries
You will need the following for this project
- Python IDE (for example, Visual Studio Code)
- Python 3.12+
- Git
# 2. Cloning
You will need to clone the files. Use
```sh
git clone https://github.com/Peggun/osd
```
This gets all of the files and ready to set up all of the packages.
# 3. Setting Up
When you have opened up the project folder, you should see a requirements.txt file. This contains all of the packages needed for this project to run. To install all of them, run
- Windows
```sh
py -m pip install -r win-requirements.txt
```
or
```sh
pip install -r win-requirements.txt
```
- Linux & MacOS
```sh
python -m pip install -r linux-mac-requirements.txt
```
This should install of the packages for the project.
Now to get all of the data, you can run the scripts in the downloads folder. The names tell you what they download
## Environment Variables
In the files, there is a .env.example file. This is an example of a proper .env file. To modify the .env file, just make a copy of the .env.example folder and rename it to .env, and change the variables as you like. The main website when I host it with the first stable release, will be different and only known to me.
# 4. Running
Now onto the final step. To run the project, just run
```sh
py run.py
```
run.py contains all of the necessary code to initialise the app and the database.
# 5. Issues
If you have ran through any issues throughout this process. Please read [ISSUES.md](https://github.com/Peggun/osd/blob/main/ISSUES.md)
# 6. Contributing
If you would like to join and contribute to this project, please read [CONTRIBUTING.md](https://github.com/Peggun/osd/blob/main/CONTRIBUTING.md)