Quickstart

Prerequisites

Build from Source

git clone https://github.com/your-org/sieve-aml.git
cd sieve-aml
mvn clean verify

This produces executable JARs for the server and CLI:

  • sieve-server/target/sieve-server-0.1.0-SNAPSHOT.jar

  • sieve-cli/target/sieve-cli-0.1.0-SNAPSHOT.jar

Start the Server

java -jar sieve-server/target/sieve-server-0.1.0-SNAPSHOT.jar

The server starts on port 8080 and automatically fetches OFAC SDN data on first startup. Once loaded, the API is ready:

curl -X POST http://localhost:8080/api/v1/screen \
  -H "Content-Type: application/json" \
  -d '{"name": "Vladimir Putin", "threshold": 0.80}'

Swagger UI is available at http://localhost:8080/swagger-ui.html.

Screen via CLI

java -jar sieve-cli/target/sieve-cli-0.1.0-SNAPSHOT.jar screen "John Doe"

The CLI auto-fetches lists if the index is empty. Exit codes:

  • 0 — no match found

  • 1 — match found (useful for CI/CD pipelines)

  • 2 — error

Next Steps