{"id":20816218,"url":"https://github.com/jstnmcbrd/delphi-ai","last_synced_at":"2025-08-09T21:08:08.162Z","repository":{"id":196133493,"uuid":"694520214","full_name":"JstnMcBrd/delphi-ai","owner":"JstnMcBrd","description":"API wrapper for the Delphi AI","archived":false,"fork":false,"pushed_at":"2025-04-30T18:41:19.000Z","size":467,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-30T19:42:23.804Z","etag":null,"topics":["ai","api","delphi","ethics","morals"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/delphi-ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JstnMcBrd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-09-21T06:57:16.000Z","updated_at":"2025-04-30T18:41:22.000Z","dependencies_parsed_at":"2023-10-03T01:38:31.613Z","dependency_job_id":"548e40f8-7943-46f9-aa07-3cb03079da26","html_url":"https://github.com/JstnMcBrd/delphi-ai","commit_stats":null,"previous_names":["jstnmcbrd/delphi-ai"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JstnMcBrd%2Fdelphi-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JstnMcBrd%2Fdelphi-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JstnMcBrd%2Fdelphi-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JstnMcBrd%2Fdelphi-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JstnMcBrd","download_url":"https://codeload.github.com/JstnMcBrd/delphi-ai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252879454,"owners_count":21818799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","api","delphi","ethics","morals"],"created_at":"2024-11-17T21:29:08.108Z","updated_at":"2025-08-09T21:08:08.144Z","avatar_url":"https://github.com/JstnMcBrd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# delphi-ai\n\n[![API Status](https://img.shields.io/github/actions/workflow/status/JstnMcBrd/delphi-ai/api-status.yml?logo=github\u0026label=API%20Status)](https://github.com/JstnMcBrd/delphi-ai/actions/workflows/api-status.yml)\n[![CI](https://img.shields.io/github/actions/workflow/status/JstnMcBrd/delphi-ai/ci.yml?logo=github\u0026label=CI)](https://github.com/JstnMcBrd/delphi-ai/actions/workflows/ci.yml)\n\u003cbr /\u003e\n[![NPM Version](https://img.shields.io/npm/v/delphi-ai)](https://www.npmjs.com/package/delphi-ai)\n[![NPM License](https://img.shields.io/npm/l/delphi-ai)](./LICENSE)\n![NPM Type Definitions](https://img.shields.io/npm/types/delphi-ai)\n![NPM Downloads](https://img.shields.io/npm/dt/delphi-ai)\n\u003cbr /\u003e\n![Node version](https://img.shields.io/node/v/delphi-ai)\n\n\u003e \u003cimg alt=\"Warning\" src=\"https://raw.githubusercontent.com/Mqxx/GitHub-Markdown/main/blockquotes/badge/dark-theme/error.svg\"\u003e \n\u003e\n\u003e This package is permanently broken and should not be used. Please read [#55](https://github.com/JstnMcBrd/delphi-ai/issues/55).\n\n## About\n\n**delphi-ai** is a simple package to interact with the API for the Delphi AI. It is developed in [TypeScript](https://www.typescriptlang.org/) and transpiles to JavaScript (ESM).\n\nDelphi is an AI released in 2021 by the **Allen Institute for Artifical Intelligence**, who described it as *\"a computational model for descriptive ethics, i.e., people's moral judgments on a variety of everyday situations.\"* Essentially, provide a prompt and the AI will judge whether it is ethical.\n\nThe [demo website](https://delphi.allenai.org/) uses an API to retrieve outputs from the computational model. This package acts as a wrapper for that API to allow you to integrate Delphi with your projects.\n\n\u003e \u003cimg alt=\"Warning\" src=\"https://raw.githubusercontent.com/Mqxx/GitHub-Markdown/main/blockquotes/badge/dark-theme/warning.svg\"\u003e\n\u003e\n\u003e The copyright for Delphi belongs to the **Allen Institute for Artifical Intelligence**. This package is unofficial and not supported by them. The API could be turned off at any time. Please check the API status above before reporting issues.\n\n## Prerequesites\n\nThis package has no production dependencies, and works with Node (`\u003e=18`) or the browser.\n\n## Installation\n\n`npm install delphi-ai`\n\n## Usage\n\nIf the API returns a non-200 response, an error will be thrown.\nNone of the examples below include error handling, but don't forget it!\n\n### ES Modules\n\n```js\nimport delphi from 'delphi-ai';\n\nconst response = await delphi('Building a rocket');\nconsole.log(response); // \"It's impressive\"\n```\n\n### CommonJS\n\n```js\nconst delphi = require('delphi-ai');\n\n(async () =\u003e {\n\tconst response = await delphi('Fighting a mummy');\n\tconsole.log(response); // \"It's wrong\"\n})();\n\n// or\n\ndelphi('Climbing up the Eiffel Tower').then((response) =\u003e {\n\tconsole.log(response); // \"It's normal\"\n});\n```\n\n## Development\n\nWhen a merge request is created, the changes must pass linting, building, and unit tests. These checks are run automatically by GitHub. You can run them manually using `npm run lint`, `npm run build`, and `npm test`.\n\nGitHub will also periodically run a test to confirm the API is still working. You can run this test manually with `npm run test-api`.\n\nWhen a new [Release](https://github.com/JstnMcBrd/delphi-ai/releases) is created, GitHub will automatically deploy the new version to the [npm registry](https://npmjs.com/package/delphi-ai).\n\nThis project abides by [Semantic Versioning](https://semver.org/) and [Keep A Changelog](https://keepachangelog.com/). To see a list of changes for each update, check the description of [releases on GitHub](https://github.com/JstnMcBrd/delphi-ai/releases).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjstnmcbrd%2Fdelphi-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjstnmcbrd%2Fdelphi-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjstnmcbrd%2Fdelphi-ai/lists"}