Node.js client for the Akinator game, an awesome genie that's able to guess any character in your mind!
This package was inspired by many akinator packages, including the python one, but the javascript versions were not good enough in my opinion or were not working.
This project is not affiiliated with Akinator in any way! It is a community project.
If you like this project, please check out Akinator!
- 👌 No dependencies (only
node-fetch
) - ✅ Written in TypeScript and strongly typed
- 🧸 Very easy to use
- ⌚ Asynchronous requests
- 🔁 Active development
npm install node_akinator
Typescript:
import { AkinatorClient, Languages, Themes, Answers } from 'node_akinator';
Javascript:
const { AkinatorClient, Languages, Themes, Answers } = require("node_akinator");
Basic automated usage:
// create the client
const akinator = new AkinatorClient(Languages.English, true, Themes.Character);
// go into async
(async() => {
// start the game
const start = await akinator.start();
console.log(start.question);
// let it run automatically until akinator won
while (!akinator.won) {
// answer yes all the time
const answer = await akinator.answer(Answers.Yes);
console.log(`(${answer.step}/100) ${answer.question}`);
// wanna go back?
// await akinator.back();
}
// win result and extra information
console.log(akinator.winResult.name);
// not satisfied? you can always continue.
// use (akinator.ko) to know if he lost.
const answer = await akinator.continue();
console.log(`(${answer.step}/100) ${answer.question}`);
// OR maybe you're satisfied,
// then tell akinator.
await akinator.submitWin();
})();
❤️ This project is updated frequently, always check for the latest version for new features or bug fixes.
🚀 If you have an issue or idea, let me know in the Issues section.
📜 If you use this API, you also bound to the terms of usage of their website.
☕ Want to support me? You can send me a coffee on ko.fi: https://ko-fi.com/coloride.
(real)coloride - 2024, Licensed MIT.