{"id":43510350,"url":"https://github.com/cefriel/coney","last_synced_at":"2026-02-03T12:50:28.951Z","repository":{"id":75925177,"uuid":"220937638","full_name":"cefriel/coney","owner":"cefriel","description":"CONEY: The CONversational survEY Toolkit","archived":false,"fork":false,"pushed_at":"2025-07-03T09:50:46.000Z","size":3229,"stargazers_count":10,"open_issues_count":2,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-09-09T23:47:48.133Z","etag":null,"topics":["conversational-interface","graph-model","questionnaire","surveys"],"latest_commit_sha":null,"homepage":"https://coney.cefriel.com","language":"CSS","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/cefriel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-11-11T08:45:27.000Z","updated_at":"2025-07-03T09:50:50.000Z","dependencies_parsed_at":"2024-01-10T18:30:17.154Z","dependency_job_id":"722b3208-8029-4ba1-91cb-6f39a1a857a5","html_url":"https://github.com/cefriel/coney","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/cefriel/coney","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cefriel%2Fconey","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cefriel%2Fconey/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cefriel%2Fconey/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cefriel%2Fconey/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cefriel","download_url":"https://codeload.github.com/cefriel/coney/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cefriel%2Fconey/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29046488,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"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":["conversational-interface","graph-model","questionnaire","surveys"],"created_at":"2026-02-03T12:50:28.011Z","updated_at":"2026-02-03T12:50:28.932Z","avatar_url":"https://github.com/cefriel.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Coney - Community Edition\n\n⚠️ The Community Edition of Coney is NO LONGER BEING DEVELOPED but we do our best to provide bug fixing/support when possible. You can find more information on the commercial version at [coney.cefriel.com](https://coney.cefriel.com/) or below in this README.\n\nConey is a complete toolkit developed by [Cefriel](https://www.cefriel.com/) for CONversational survEYs offering components to design and administer surveys, and to analyse data.\n\n\u003cp align=\"left\"\u003e\u003cimg src=\"/coney-community.png\" alt=\"Coney components\" width=\"600\"\u003e\u003c/p\u003e\n\n### Abstract\n\nConey is an innovative toolkit designed to enhance the user experience in surveys completion. Coney exploits a conversational approach: on the one hand, Coney allows modelling a conversational survey with an intuitive graphical editor; on the other hand, it allows publishing and administering surveys through a chat interface. Coney allows defining an arbitrary acyclic graph of interaction flows, in which the following question depends on the previous answer provided by the user. This offers a high degree of flexibility to survey designers that can simulate a human to human interaction, with a storytelling approach that enables different personalized paths. Coney’s interaction mechanism exploits the advantages of qualitative methods while performing quantitative research, by linking questions to the investigated variables and encoding answers. A preliminary evaluation of the approach shows that users prefer conversational surveys to traditional ones.\n\nConey's underlying data model is based on the [survey ontology](https://w3id.org/survey-ontology) that we designed to represent, annotate, export and share both the questionnaire structure and the gathered responses. Furthermore, questions and answers can be semantically annotated at design time to easily elaborate and inter-link the collected data at analysis time. \n\nYou can know more about Coney and try it at [coney.cefriel.com/](https://coney.cefriel.com/)!\n\n### Clone the repository\n\nTo clone the repository you can run the following command:\n```\ngit clone https://github.com/cefriel/coney.git\n```\n\nThe development is no longer handled using submodules.\n\n### Toolkit Usage\n\nThe repository contains a docker-compose file to build and deploy the entire project. Each Coney component contains its own Dockerfile to build the related Docker image.\n\nA utility script is added to the repository to handle common commands. Check line endings before running it on Windows.\n\n```\n$ sh coney.sh help\n\nUsage: \u003ccommand\u003e [image] [options]\n\nCommands:\n         build           Builds the selected image with the available 'environment.ts' file\n         up              Starts the selected container (all if no image is specified)\n         stop            Stops the selected container (all if no image is specified)\n\nImages:\n         api             Coney's Application Programming Interface\n         create          Conversation editor\n         chat            User's chat endpoint\n         inspect         Realtime data visualization tool\n\nOptions:\n         --env-cp        Rewrites the environment.ts file in the Angular service(s)\n```\n\n### Deployment\n\nThe provided docker-compose file is configured to launch a local instance of Coney. We assume [Docker](https://docs.docker.com/get-docker/) is up and running on your machine. Then execute the following commands to launch Coney (depending on your operating system you may need to run the commands using `sudo` to reach the Docker Daemon):\n\n```\nsh coney.sh build\nsh coney.sh up\n```\n\nTo deploy Coney in a different environment the following actions are required to configure the deployment.  \n\n_Basic deployment_:\n- Edit the `nginx.conf` file to configure the reverse-proxy. In particular update the `server_name`. \n- Set the `BASE_HREF` for Angular using the related env variable when launching the build with docker-compose.\n\t```\n\texport BASE_HREF=/coney\n\tdocker-compose build --no-cache\n\t```\n- Change the file `environment.ts` to set the `baseUrl` that should used by Coney components to reach the back-end (coney-api).\n- Change the file `environment.ts` to set the `privacyUrl` shown to users compiling surveys through the coney-chat component.\n- Launch the build using the `--env-cp` option\n\t```\n\tsh coney.sh build --env-cp\n\t```\n\n_Notes_:\n- Unpublished surveys and `coney-api` logs are saved in the `coney-data` folder in the host filesystem. The content of the `coney-data` folder is added to the `.gitignore` file by default.\n- The docker-compose deployment can be initialized with a set of surveys. \nPut coney-create files in `coney-data` and update the `query.sh` file to initialize the database accordingly.\nA default coney-demo survey is provided. `TODO` create a script to automatically build queries given the content of `coney-data` folder.\n- Pay attention to line endings when modifying the `query.sh`, they should be UNIX style.\n- Data of Neo4j are persisted in a `neo4j/` folder in the host filesystem. The `neo4j/` folder is added to the `.gitignore` file.\n\n### Components\nOnce running, the landing page is available at `localhost/coney`. All components are masked by a reverse-proxy.\n\nComponents are reachable at the following addresses:\n- coney-create `localhost/coney/create`\n- coney-inspect `localhost/coney/inspect`\n- coney-chat `localhost/chat` (a valid payload is needed to correctly visualize the chat component)\n\nThe backend API can be reached at `localhost/coney-api/\u003cmethod_name\u003e`. If enabled at build time, the API documentation is available at `localhost/coney-api/swagger-ui.html`.\n\nMore information on the components and how to use them are available in the repository Wiki.\n\n### Coney Enterprise Edition\n\nThe Coney Enterprise Edition is mainly based on the open-source components, but offers additional features:\n- Multi-user and multi-project features to support hierarchies and access levels for surveys\n- Centralized console to access Coney components and browse projects and surveys\n- Link personalization for survey delivery (users, metadata, limit to number completions)\n- Chat interface personalization (colors, logo, etc.)\n \nIf you are interested, if you simply want to know more, and/or if you need help in the survey design process contact us at [coney-dev@cefriel.com](mailto:coney-dev@cefriel.com).\n\n### Coney In-Use\n\nPublished studies using Coney:\n- Survey Study about Motivation for Participants in Citizen Science Projects [Data set]. Zenodo. https://doi.org/10.5281/zenodo.5753091\n- Ride2Rail Choice Criteria Survey Dataset [Data set]. Zenodo. http://doi.org/10.5281/zenodo.4593471\n\nTo add something to the list please either submit a pull request or open an issue.\n\n### Publications\n\nTo know more in details the project you can access related pubblications:\n- _CHItaly 2019_: Extended abstract and poster \"CONEY: A CONversational survEY Toolkit\" on [Zenodo](https://doi.org/10.5281/zenodo.3446014)\n- _IJHCS 2020_: Journal paper \"Submitting surveys via a conversational interface: An evaluation of user acceptance and approach effectiveness\" on [Arxiv](https://arxiv.org/pdf/2003.02537.pdf)\n\n### Cite as\n\nIf you used Coney in your work, please cite the IJHCS article:\n\n\u003e Irene Celino and Gloria Re Calegari: _Submitting surveys via a conversational interface: an evaluation of user acceptance and approach effectiveness_, International Journal of Human Computer Studies, Vol. 139, DOI: [10.1016/j.ijhcs.2020.102410](https://doi.org/10.1016/j.ijhcs.2020.102410), 2020.\n\nBibTeX reference:\n\n```bib\n@article{celino2020submitting,\ntitle = \"Submitting surveys via a conversational interface: An evaluation of user acceptance and approach effectiveness\",\njournal = \"International Journal of Human-Computer Studies\",\nvolume = \"139\",\npages = \"102410\",\nyear = \"2020\",\nissn = \"1071-5819\",\ndoi = \"https://doi.org/10.1016/j.ijhcs.2020.102410\",\nauthor = \"Irene Celino and Gloria {Re Calegari}\"\n}\n```\n\n### Contributing\n\nBefore contributing, please read carefully, complete and sign our [Contributor Licence Agreement](https://github.com/cefriel/contributing/blob/main/contributor-license-agreement.pdf). \n\nWhen contributing to this repository, please first discuss the change you wish to make via issue or any other available method with the repository's owners.\n\n### License\n\n_Copyright 2020 Cefriel._\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n### Acknowledgement\n\nThis project is partially supported by the ACTION project (grant agreement number 824603), co-funded by\nthe European Commission under the Horizon 2020 Framework Programme.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcefriel%2Fconey","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcefriel%2Fconey","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcefriel%2Fconey/lists"}