risk-atlas-nexus 1.0.4

Risk Atlas Nexus provides tooling to help bring together disparate resources related to governance of foundation models.

Risk Atlas Nexus

👉 (Jun-2025) Our HF spaces demo site has been updated to show related benchmarks!

👉 (Jun-2025) The demo projects repository showcases implementations of Risk Atlas Nexus.

Overview

Risk Atlas Nexus provides tooling to help bring together resources related to governance of foundation models. We support a community-driven approach to curating and cataloguing resources such as datasets, benchmarks and mitigations. Our goal is to turn abstract risk definitions into actionable workflows that streamline AI governance processes. By connecting fragmented resources, Risk Atlas Nexus seeks to fill a critical gap in AI governance, enabling stakeholders to build more robust, transparent, and accountable systems. Risk Atlas Nexus builds on the IBM AI Risk Atlas making this educational resource a nexus of governance assets and tooling. An AI System's Knowledge Graph is used to provide a unified structure that links and contextualize the very heterogeneous domain data.

Our intention is to create a starting point for an open AI Systems ontology whose focus is on risk and that the community can extend and enhance. This ontology serves as the foundation that unifies innovation and tooling in the AI risk space. By lowering the barrier to entry for developers, it fosters a governance-first approach to AI solutions, while also inviting the broader community to contribute their own tools and methodologies to expand its impact.

Features

• 🏗️ An ontology that combines the AI risk view (taxonomies, risks, actions) with an AI model view (AI systems, AI models, model evaluations) into one coherent schema
• 📚 AI Risks collected from IBM AI Risk Atlas, IBM Granite Guardian, MIT AI Risk Repository, NIST Artificial Intelligence Risk Management Framework: Generative Artificial Intelligence Profile, the AI Risk Taxonomy (AIR 2024), the AILuminate Benchmark, Credo's Unified Control Framework, and OWASP Top 10 for Large Language Model Applications
• 🔗 Mappings are proposed between the taxonomies and between risks and actions
• 🐍 Use the python library methods to quickly explore available risks, relations and actions
• 🚨 Use the python library methods to detect potential risks in your usecase
• 📤 Download an exported graph populated with data instances
• ✨ Example use-case of auto-assistance in compliance questionnaires using CoT examples and Risk Atlas Nexus
• 🔧 Tooling to convert the LinkML schema and instance data into a Cypher representation to populate a graph database

Architecture

Links

• AI Risk Ontology
  • LinkML schema documentation
  • LinkML instance data for an example knowledge graph
  • Download a populated graph
  • Contribute your own taxonomy files and CoT templates
• Notebooks:
  • Risk Atlas Nexus Quickstart Overview of library functionality
  • Risk identification Uncover risks related to your usecase
  • Auto assist questionnaire Auto-fill questionnaire using Chain of Thought or Few-Shot Examples
  • AI Tasks identification Uncover ai tasks related to your usecase
  • AI Domain identification Uncover ai domain from your usecase
  • Risk Categorization Assess and categorize the severity of risks associated with an AI system usecase.
• Additional Resources:
  • IBM AI Risk Atlas
  • Usage Governance Advisor: From Intent to AI Governance

Installation

This project targets python version ">=3.11, <3.12". You can download specific versions of python here: https://www.python.org/downloads/

Note: Replace INFERENCE_LIB with one of the LLM inference library [ollama, vllm, wml, rits] as explained here

To install the current release

pip install "risk-atlas-nexus[INFERENCE_LIB]"

To install the latest code

git clone [e-mail]:IBM/risk-atlas-nexus.git
cd risk-atlas-nexus
python -m venv vrisk-atlas-nexus
source vrisk-atlas-nexus/bin/activate
pip install -e ".[INFERENCE_LIB]"

Install for inference APIs

Risk Atlas Nexus uses Large Language Models (LLMs) to infer risks and risks data. Therefore, requires access to LLMs to inference or call the model. The following LLM inference APIs are supported:

• IBM Watsonx AI (Watson Machine Learning)
• Ollama
• vLLM
• RITS (IBM Internal Only)

IBM Watsonx AI (WML)

When using the WML platform, you need to:

1. Add configuration to .env file as follows. Please follow this documentation on obtaining WML credentials.

WML_API_KEY=<WML api key goes here>
WML_API_URL=<WML url key goes here>
WML_PROJECT_ID=<WML project id goes here, Optional>
WML_SPACE_ID=<WML space id goes here, Optional>

Either 'WML_PROJECT_ID' or 'WML_SPACE_ID' need to be specified.

2. Install WML dependencies as follows:

pip install -e ".[wml]"

Ollama

When using the Ollama inference, you need to:

1. Install Ollama dependencies as follows:

pip install -e ".[ollama]"

2. Please follow the quickstart guide to start Ollama LLM server. Server will start by default at http://localhost:11434

3. When selecting Ollama engine in Risk Atlas Nexus, use the server address localhost:11434 as the api_url in the credentials or set the environment variable OLLAMA_API_URL with this value.

vLLM

When using the vLLM inference, you need to:

1. For Mac users, follow the instuctions here. Users need to build from the source vLLM to natively run on macOS.

2. For Linux users, install vLLM dependencies as follows:

pip install -e ".[vllm]"

Above package is enough to run vLLM in once-off offline mode. When selecting vLLM execution from Risk Atlas Nexus, credentials should be passed as None to use vLLM offline mode.

3. (Optional) To run vLLM on an OpenAI-Compatible vLLM Server, execute the command:

vllm serve ibm-granite/granite-3.1-8b-instruct --max_model_len 4096 --host localhost --port 8000 --api-key <CUSTOM_API_KEY>

The CUSTOM_API_KEY can be any string that you choose to use as your API key. Above command will start vLLM server at http://localhost:8000. The server currently hosts one model at a time. Check all supported APIs at http://localhost:8000/docs

Note: When selecting vLLM engine in Risk Atlas Nexus, pass api_url as host:port and given api_key to credentials with values from the vllm serve command above.

RITS (IBM Internal Only)

When using the RITS platform, you need to:

1. Add configuration to .env file as follows:

RITS_API_KEY=<RITS api key goes here>
RITS_API_URL=<RITS url key goes here>

2. Install RITS dependencies as follows:

pip install -e ".[rits]"

Compatibility

• View the releases changelog.

Referencing the project

If you use Risk Atlas Nexus in your projects, please consider citing the following:

@article{airiskatlas2025,
      title={AI Risk Atlas: Taxonomy and Tooling for Navigating AI Risks and Resources},
      author={Frank Bagehorn and Kristina Brimijoin and Elizabeth M. Daly and Jessica He and Michael Hind and Luis Garces-Erice and Christopher Giblin and Ioana Giurgiu and Jacquelyn Martino and Rahul Nair and David Piorkowski and Ambrish Rawat and John Richards and Sean Rooney and Dhaval Salwala and Seshu Tirupathi and Peter Urbanetz and Kush R. Varshney and Inge Vejsbjerg and Mira L. Wolf-Bauwens},
      year={2025},
      eprint={2503.05780},
      archivePrefix={arXiv},
      primaryClass={cs.CY},
      url={https://arxiv.org/abs/2503.05780}
}

License

Risk Atlas Nexus is provided under Apache 2.0 license.

Contributing

• Get started by checking our contribution guidelines.
• Read the wiki for more technical and design details.
• If you have any questions, just ask!
• Contribute your own taxonomy files and CoT templates

Tip: Use the makefile provided to regenerate artifacts provided in the repository by running make in this repository.

Find out more

• Try out a quick demo at the HF spaces demo site
• Read the publication AI Risk Atlas: Taxonomy and Tooling for Navigating AI Risks and Resources
• Explore IBM's AI Risk Atlas on the IBM documentation site
• View the demo projects repository showcasing implementations of Risk Atlas Nexus.
• Read the the IBM AI Ethics Board publication Foundation models: Opportunities, risks and mitigations which goes into more detail about the risk taxonomy, and describes the point of view of IBM on the ethics of foundation models.
• 'Usage Governance Advisor: From Intent to AI Governance' presents a system for semi-structured governance information, identifying and prioritising risks according to the intended use case, recommending appropriate benchmarks and risk assessments and proposing mitigation strategies and actions.

IBM ❤️ Open Source AI

Risk Atlas Nexus has been brought to you by IBM.