yente is an open source data match-making API. It provides functions search, retrieve or match FollowTheMoney entities, including people, companies or vessels that are subject to international sanctions.
yente: Intro · Deployment · Settings · Custom datasets · FAQ
yente requires a server that can run host the main screening application (a lightweight Python application) and the ElasticSearch backend used to store and query entity information. In total, we anticipate 500 MB memory per Python service, and 4-6GB of memory for the ElasticSearch index. Running ElasticSearch on SSD-backed hard drives will produce a significant performance gain.
While it is possible to operate
yente outside of Docker, we strongly encourage the use of containers as a simple means of dependency management and deployment.
In order to deploy
yente on your own servers, we recommend you use
docker-compose (or another Docker orchestration tool) to pull and run the pre-built containers. For example, you can download the
docker-compose.yml in the repository and use it to boot an instance of the system:
mkdir -p yente && cd yente wget https://raw.githubusercontent.com/opensanctions/yente/main/docker-compose.yml docker-compose up
This will make the service available on Port 8000 of the local machine. You may have to wait for five to ten minutes until the service has finished indexing the data when it is first started.
Next: Configure yente
If you run the container in a cluster management system like Kubernetes, you will need to run both of the services defined in the compose file (the API and ElasticSearch instance). You may also need to assign the API container network policy permissions to fetch data from
data.opensanctions.org once every hour so that it can update itself.
OpenSanctions is free for non-commercial users. Businesses must acquire a data license to use the dataset.