{"id":14985583,"url":"https://github.com/jondotsoy/cofy","last_synced_at":"2026-01-25T07:03:08.929Z","repository":{"id":245378593,"uuid":"818074626","full_name":"JonDotsoy/cofy","owner":"JonDotsoy","description":"[unstable] Conversational AI project for facilitating conversations using YAML files","archived":false,"fork":false,"pushed_at":"2024-08-19T21:07:39.000Z","size":450,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-05-30T20:38:10.804Z","etag":null,"topics":["artificial-intelligence","chatbot-framework","conversation-management","conversational-ai","yaml"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JonDotsoy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-21T03:44:28.000Z","updated_at":"2024-12-23T19:00:22.000Z","dependencies_parsed_at":"2024-08-18T22:52:03.254Z","dependency_job_id":"ca1dcae1-d6f9-4363-a20f-370f122f7f22","html_url":"https://github.com/JonDotsoy/cofy","commit_stats":null,"previous_names":["jondotsoy/q-project","jondotsoy/cofy"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/JonDotsoy/cofy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonDotsoy%2Fcofy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonDotsoy%2Fcofy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonDotsoy%2Fcofy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonDotsoy%2Fcofy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JonDotsoy","download_url":"https://codeload.github.com/JonDotsoy/cofy/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonDotsoy%2Fcofy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28747308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T05:12:38.112Z","status":"ssl_error","status_checked_at":"2026-01-25T05:04:50.338Z","response_time":113,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["artificial-intelligence","chatbot-framework","conversation-management","conversational-ai","yaml"],"created_at":"2024-09-24T14:11:14.734Z","updated_at":"2026-01-25T07:03:08.912Z","avatar_url":"https://github.com/JonDotsoy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Project Cofy: Simplifying Conversational AI Development\n\nProject Cofy is an open-source project that aims to simplify the task of working with artificial intelligence models, making it easier for developers and researchers to create and manage conversations using a YAML file directly. By providing a user-friendly interface through a text editor, Cofy eliminates the need for complex programming knowledge or APIs, streamlining the workflow for those working with conversation AI.\n\nThe inspiration behind Project Cofy is to make AI development more accessible to a wider range of users, from developers and researchers to students and hobbyists. By leveraging YAML files as a simple and intuitive input format, Cofy reduces the barrier of access, allowing users to focus on creating innovative conversations without having to struggle with complex code or APIs.\n\n**Demo**\n\n[![demo](./assets/imgs/screen_recording_2024-06-27_2.03.20 PM.jpg)](https://youtu.be/4lEQjqxf6gU)\n\n**Content**\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Manifest File Format](#manifest-file-format)\n\n## Installation\n\nTo install Project Cofy, you can use Homebrew on macOS. Simply execute the following command in your terminal:\n\n```\nbrew install jondotsoy/core/cofy\n```\n\nAlternatively, you can also install it locally on any system.\n\n### Local Installation\n\nBefore installing Project Cofy, you need to have Bun.js installed on your system. You can download and install Bun.js from its official website: https://bun.sh\n\n**Install**\n\nClone the repository:\n\n```shell\ngit clone https://github.com/JonDotsoy/cofy-project.git\n```\n\nInstall dependencies:\n\n```shell\nmake install\n```\n\nBuild the project:\n\n```shell\nmake build\n```\n\nThis will compile the binary in `./dist/cofy`.\n\n## Usage\n\n### Create a Conversation using a YAML File:\n\nThe manifest file in YAML format can contain the following structure:\n\n```yaml\n# manifest.yaml\nmessages:\n  - system: |\n      You are an expert at creating short jokes.\n  - user: |\n      Tell me a joke\n```\n\nThis file describes a conversation with the AI, within `messages` you control the flow of the conversation, write what says the role of `system`, `assistant` and `user`.\n\n**Run Cofy:**\n\nAfter creating the file, you can run `cofy` to continue the conversation with the AI.\n\n```shell\ncofy manifest.yaml\n```\n\nCofy will process the YAML file and respond with a message based on the flow of conversation defined.\n\n```yaml\nmessages:\n  - system: |\n      You are an expert at creating short jokes.\n  - user: |\n      Tell me a joke\n  - assistant: |-\n      Here's one:\n\n      Why couldn't the bicycle stand up by itself?\n\n      (Wait for it...)\n\n      Because it was two-tired!\n\n      (get it?)\n```\n\n### Run a Conversation Saved\n\nThere are agents that you can run quickly from [Cofy Github](https://github.com/JonDotsoy/cofy/tree/develop/agents) a repository in Github or from your local machine.\n\nThe following example downloads the agent from https://github.com/JonDotsoy/cofy/blob/develop/agents/commit-message.agent and processes locally to create an automatic message for saved conversations.\n\n![result to run `cofy commit-message`](./docs/samples/run-cofy-commit-message-agent.png)\n\n## Manifest File Format\n\nFor more information about the manifest file format, you can check out [manifest.md](./docs/manifest.md).\n\n## Roadmap\n\nTo see upcoming improvements to this project, read the [ROADMAP](./ROADMAP.md) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjondotsoy%2Fcofy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjondotsoy%2Fcofy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjondotsoy%2Fcofy/lists"}