Skip to content

BloomTech-Labs/human-rights-first-asylum-ds-a

Repository files navigation

Human Rights First - Asylum

An application to assist immigration attorneys and refugee representatives in advocating for clients in asylum cases by identifying patterns in judicial decisions and predicting possible outcomes based on those patterns.

Product Mission and Goals

Human Rights First (HRF) is a non-profit, nonpartisan, 501(c)(3), international human rights organization based in New York, Washington D.C., Houston, and Los Angeles. HRF works to link immigration attorneys and advocates with asylum seekers and provide those attorneys with resources to represent their clients. Our application leverages historical data to inform advocates better of a judge's past decisions. The hope is that advocates for asylum seekers can use our tools to tailor their arguments before a particular judge and maximize their client's chances of receiving asylum.

Architecture

image
This diagram shows the current state of the architecture.

Screen Shot 2021-09-22 at 11 58 06 AM This diagram shows the flow of data between frontend, backend, data science, and the database.

Codebases

Front-End
Uses NodeJS to create the web-based user interface for uploading case documents, managing users, and viewing data in the form of tables and visualizations.

Back-End
Uses Javascript and Postgres to manage databases containing tables for users, judges, and cases.

Data Science
Uses Python and Tesseract for optical character recognition (OCR) to convert pdf images into text data that can be searched via natural language processing (NLP) techniques. Key data, which we refer to as structured fields, are extracted from the text data and sent to the back-end for storage.

Our Role

See this team's history here.

Files

The app folder contains the FastAPI application which creates an endpoint for processing a single .pdf file stored in the AWS S3 bucket.

Valuable Readmes

  • VISUALIZATIONS_INFO contains information pertaining to the visualizations.py as well as the main.py file and how they interact with each other.
  • SCRAPER_INFO contains important information about the status of each function used to extract fields from documents.
  • READMEdev contains AWS CLI2 installation instruction

Additional Readmes

  • KnownDefects contains information about potential issues to be aware of.
  • NOTEBOOKS contains helpful information about the notebooks and scripts used to explore solutions for scrapper.
  • visualizations/README contains helpful information about notebooks, scripts, and data used to explore visualizations.

Tools

API Installation

After cloning the repository, in your command line run the following commands: Replace with a name of your choice.

docker build . -t <name>
docker run -it -p 5000:5000 <name> uvicorn app.main:app --host=0.0.0.0 --port=5000

NOTE: An error may be thrown when trying to run the app if you have not added the .env file with aws credentials
NOTE: env file should have 4 env variables namely ACCESS_KEY,SECRET_KEY, BUCKET_NAME, DB_URL
NOTE: Uncomment COPY .env .env in dockerfile before run docker locally

Then open http://0.0.0.0:5000 in your browser. The application should be running.
If 0.0.0.0 does not work, try http://localhost:5000

Contributors

Labs 37

Lucas Chatham
Trevor Dewalt Azamatkhuja Jalilov Matthew Blackburn Zunera Bokhari Joel Hoover Lee Rowe

Labs 37

Minh Nguyen
Waqas Khwaja
Jason Young
Andrew Lee
Michael Carrier

Labs 35

Dylan Sivori
Frank Howd
Malachi Ivey

Labs 34

Jacob Bohlen
Kevin Weatherwalks
River Bellamy
Patrick Raborn
Ricardo Rodriguez
Filipe Collares
Nicholas Major
Evan Grinalds
Joe Sasson

Labs 33

Michael Kolek
Francis LaBounty
Jennifer Faith
Brett Doffing
Daniel Fernandez
Kevin Weatherwalks
Alex Krieger

Labs 32

Bharath Gogineni
Jace Hambrick
Nicholas Adamski
Rassamy J. Soumphonphakdy

Labs 31

Rebecca Duke Wiesenberg
Reid Harris
Lucas Petrus
Noah Caldwell

Labs 30

Tomas Phillips
Sean Byrne
Henry Gultom
RJ Proctor

Labs 29

Liam Cloud Hogan
Steven Lee
Edwina Palmer
Tristan Brown

License

This project is licensed under the terms of the MIT license.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages