{"id":40116299,"url":"https://github.com/clbustos/buhos","last_synced_at":"2026-01-19T12:30:39.872Z","repository":{"id":29715223,"uuid":"118925832","full_name":"clbustos/buhos","owner":"clbustos","description":"Web based systematic literature review software","archived":false,"fork":false,"pushed_at":"2025-11-20T03:59:48.000Z","size":48584,"stargazers_count":40,"open_issues_count":7,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-17T18:02:29.554Z","etag":null,"topics":["review","ruby","systematic-reviews"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clbustos.png","metadata":{"files":{"readme":"README.es.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":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-01-25T14:49:33.000Z","updated_at":"2025-11-20T19:04:33.000Z","dependencies_parsed_at":"2024-01-08T04:44:05.619Z","dependency_job_id":"a6e1677a-468b-480b-8010-19c0758a75f0","html_url":"https://github.com/clbustos/buhos","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/clbustos/buhos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clbustos%2Fbuhos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clbustos%2Fbuhos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clbustos%2Fbuhos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clbustos%2Fbuhos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clbustos","download_url":"https://codeload.github.com/clbustos/buhos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clbustos%2Fbuhos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28567877,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T08:53:44.001Z","status":"ssl_error","status_checked_at":"2026-01-19T08:52:40.245Z","response_time":67,"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":["review","ruby","systematic-reviews"],"created_at":"2026-01-19T12:30:31.525Z","updated_at":"2026-01-19T12:30:39.847Z","avatar_url":"https://github.com/clbustos.png","language":"JavaScript","readme":"\u003cimg src=\"http://buhos.org/public/logo.svg\" width=\"225\" alt=\"Buhos Logo\" /\u003e\n\n\n[![CircleCI](https://circleci.com/gh/clbustos/buhos/tree/master.svg?style=svg)](https://circleci.com/gh/clbustos/buhos/tree/master)\n[![Mantenibilidad](https://api.codeclimate.com/v1/badges/ffa582598127f86ed405/maintainability)](https://codeclimate.com/github/clbustos/buhos/maintainability)\n[![Cobertura de pruebas](https://api.codeclimate.com/v1/badges/ffa582598127f86ed405/test_coverage)](https://codeclimate.com/github/clbustos/buhos/test_coverage)\n\nPlataforma basada en web para gestionar el proceso completo de revisiones sistemáticas de literatura. Desarrollado usando Sinatra, un DSL  basado en Ruby.\n\n\n## Características\n\n* Multi-platforma: Corre en Linux(probado en Ubuntu 14.04, 16.06, 18.04, 21.10), Windows (probado en Windows 7 y 10) y MacOS (probado en High Sierra)\n* Puede ser usado para realizar revisiones sistemáticas por un individuo o por un grupo de trabajo.\n* Sistema de mensajería interna, para mensajes personales o relacionados a las revisiones sistemáticas.\n* Multilenguaje, usando *I18n*. Disponible en inglés y español.\n* Flujo de trabajo flexible. Las etapas principales de buscar textos, tamizar los artículos pertinentes, extraer información y realizar reportes están claramente definidas. Sin embargo, es posible realizar cambios en cualquier etapa ya concluida, afectando las etapas posteriores.\n* Importa información desde distintas bases de datos bibliográficas, como - WoS, Scopus, Ebscohost, Scielo - usando BibTeX.\n* Integración con Crossref, lo que permite eliminar artículos duplicados (usando DOI), así como buscar información sobre referencias.\n* Repositorio de archivos. Se pueden ver en línea archivos PDF y ODF, usando  [ViewerJS](http://viewerjs.org/)\n* Múltiples formas de analizar datos: se pueden incorporar comentarios y etiquetas en cada etapa, así como generar formularios personalizados para extraer información.\n* Distintos tipos de reporte: se cuenta con reportes para los datos extraídos de los textos, un reporte detallado del proceso de decisión en cada etapa de la revisión, así como un [diaframa de flujo PRISMA](http://prisma-statement.org/prismastatement/flowdiagram.aspx) para resumir el proceso, listo para publicaciones.\n* Distintos tipos de archivos para exportar: Se pueden exportar las referencias como BibTeX, así como generar archivos GraphML para realizar análisis de grafos.\n* Test unitarios y de integración para los principales recursos del software\n\n\nUsando como referencia a Kitchenham \u0026 Chartes (2007), Buhos apoya de forma completa la fase de 'realizar la revisión', y de forma parcial las otras etapas\n\n### Planning the review\n\nEtapa                                            | Soporte\n-------------------------------------------------|--------\nIdentíficación de la necesidad de una revisión   | No\nComisionar la revisión                           | No\nEspecificar la(s) pregunta(s) de investigación   | Sí\nDesarrollar un protocolo de revisión             | Sí\nEvaluar el protocolo de revisión                 | Sí\n\n### Realizar la revisión\n\nEtapa                                     | Soporte\n------------------------------------------|--------\nIdentificación de investigaciones         | Sí\nSelección de estudios primarios           | Sí\nEvaluación de calidad de los estudios     | Sí\nExtracción de información y monitoreo     | Sí\nSíntesis de información                   | Sí\n\n### Reportar la revisión\n\nEtapa                                     | Soporte\n------------------------------------------|--------\nEspecificar mecanismos de difusión        | No\nFormatear el formato final                | Parcial\nEvaluar el reporte                        | No\n\n\n\n## Documentación\n\nSe cuenta con un manual disponible en  [español](https://buhos.org/manual/es/) e [inglés](https://buhos.org/manual/en/), que contiene una guía rápida para entender la metodología de revisión sistemática que sustena el software.\n\nLa API está documentada usando [Yard](https://yardoc.org/) y está disponible en [https://www.buhos.org/api](https://www.buhos.org/api). Sólo se encuentra disponible en inglés.\n\n## Comenzar a trabajar\n\n### En Windows\n\nSe puede obtener el instalador de Windows desde  [Buhos Windows Toolkit](https://github.com/clbustos/buhos-windows-tk/tree/master/windows_installer)\n\n### En *nix\n\nPara Debian, Ubuntu y CentOS, se encuentran disponibles paquetes e instrucciones de instalación en  [packager.io](https://packager.io/gh/clbustos/buhos).  Como ejemplo, para instalar en Ubuntu se pueden seguir las siguientes instrucciones, usando localhost:4567 como URL\n\n    wget -qO- https://dl.packager.io/srv/clbustos/buhos/key | sudo apt-key add -\n    sudo wget -O /etc/apt/sources.list.d/buhos.list \\\n      https://dl.packager.io/srv/clbustos/buhos/master/installer/ubuntu/16.04.repo\n    sudo apt-get update\n    sudo apt-get install buhos\n    sudo buhos config:set PORT=4567\n    sudo buhos scale web=1\n    sudo buhos restart \n\n### Usar vagrant\n\nEn los directorios vendor/vagrant_alpine y vendor/vagrant_ubuntu_16 pueden configuraciones de vagrant para Alpine y Ubuntu 16.04, respectivamente. Se pueden ejecutar usando\n    \n    \u003e vagrant up\n    \nDe forma predeterminada, la aplicación corre en el puerto 4567.\n    \n### Usando código fuente (última versión)\n\n#### Requisitos previos\n\n\nEn linux, se necesita una instalación de Ruby 2.4 o 2.5 con bundler, y bibliotecas de desarrollo para mysql y sqlite. Recomendamos usar [RVM](https://rvm.io/).\n\n\nEn Ubuntu, este script instala todas las dependencias\n\n\n    # Update system\n    apt-get update\n    apt-get upgrade -y\n    \n    apt-get install -y \\\n      cloc \\\n      gdal-bin \\\n      gdebi-core \\\n      git \\\n      libcurl4-openssl-dev \\\n      libgdal-dev \\\n      libproj-dev \\\n      libxml2-dev \\\n      ghostscript \\\n      imagemagick \\\n      xpdf \\\n      build-essential \\\n      libmysqlclient-dev \\\n      libsqlite3-dev\n    \n    # Install RVM\n    \n    gpg --keyserver hkp://keys.gnupg.net \\\n          --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3\n    curl -sSL https://get.rvm.io | bash -s $1\n    \n      \nEn alpine, la configuración básica es\n\n    apk update\n    apk upgrade\n    apk --update add --virtual \\\n        build-dependencies \\\n        ruby-dev \\\n        build-base \\\n        ruby \\\n        libffi-dev \\\n        libxml2-dev \\\n        libxslt-dev \\\n        mariadb-dev \\\n        sqlite-dev \\\n        ruby-json \\\n        ruby-bigdecimal \\\n        ruby-etc    \n\nUna vez que todas las dependencias han sido instaladas, se puede copiar el código fuente haciendo\n\n   \u003e git clone git@github.com:clbustos/buhos.git\n\nSe instalan las dependencia de Ruby necesarias usando bundler\n\n   \u003e bundle install\n   \nY se ejecuta la aplicación corriendo\n\n   \u003e ruby app.rb\n\nor\n\n   \u003e rackup\n## Configuración post-instalación\n\nLa aplicación se configura mediante la web. Una vez que el servidor se inicia, se debe apuntar el navegador de forma predeterminada a http://localhost:4567, para iniciar el proceso de instalación.\n\nSi desea utilizar una base de datos MySQL, se debe crear antes de configurar el software. Usando el usuario root de MySQL, las instrucciones serían \n\n    CREATE DATABASE buhos;\n    CREATE USER buhos_user@localhost IDENTIFIED BY 'password';\n    GRANT ALL PRIVILEGES ON buhos.* TO buhos_user@localhost;\n    FLUSH PRIVILEGES;\n\nPrimero, debe definir el lenguaje de instalación. Segundo, debe proveer información acerca de la base de datos específica (sqlite / mysql); de forma predeterminada, se instala una base sqlite en db.sqlite. Si se cuenta con una clave SCOPUS API, se puede entregar la información pertinente, junto con la configuración del proxy, si corresponde. \nComo paso final, se llena la base de datos. Se debe reiniciar la aplicación antes de usarla.\n\n    \n\n## Implementación\n\nPara su uso individual, la aplicación puede ejecutarse sin problemas usando el instalador en Windows, o los paquetes para Ubuntu, Debian o CentOS.\n\nPara su uso en línea por múltiples usuarios, se ha probado el uso de Buhos desplegado en un servidor HTTP independiente, usando Passenger como conector con Nginx. Para la base de datos, se ha usado MySQL. En teoría, el software debería funcionar sin problemas en MariaDB y Apache.\n\nUna configuración típica para nginx debería lucir como:\n    \n    server {\n      listen 80\n      root /home/\u003cuser\u003e/\u003cbase_dir\u003e; \n      passenger_enabled on; \n      passenger_ruby \u003cruby_location\u003e \n    }\n\nEl ubicación del ejecturable ruby se puede obtener desde \n\n    \u003e which ruby\n\nSi se ocupa [RVM](https://rvm.io/) con Passenger, revise [esta página](https://rvm.io/deployment/passenger)\n\n\n## Construido con \n* [Sinatra](http://sinatrarb.com/) - Sinatra es un DSL para crear aplicaciones web en Ruby con mínimo esfuerzo\n* [Sequel](https://github.com/jeremyevans/sequel) - Sequel es un set de herramientas para bases de datos.Provee una capa de abstracción y funcionalidades ORM, entre otras cosas.\n\n* [Bootstrap](https://getbootstrap.com/) -  Bootstrap es un set de herramientas de código abierto para desarrollar HTML, CSS, y JS.\n* [jQuery](https://jquery.com/) - jQuery is una librería muy usada para JavaScript.\n* [ViewerJS](http://viewerjs.org/) - ViewerJS permite visualizar en línea archivos PDF y ODT.\n* [RubyMine](https://www.jetbrains.com/ruby/) - Un muy buen IDE para Ruby\n\n## Cómo contribuir\n\nSi quiere contribuir, envíe un email a clbustos_at_gmail.com. Si quiere enviar un parche, lo ideal es crear una versión (fork) del repositorio en [github](https://github.com/clbustos/buhos) y realizar una petición pull.\n\n## Como se identificar las versiones\n\nUsamos [SemVer](http://semver.org/) para for identificar las versiones. Para ver las versiones disponibles del software, revise los [tags en este repositorio](https://github.com/clbustos/buhos/tags). \n\n## Autoría\n\n### Desarrolladores\n\n* **Claudio  Bustos** - *Desarrollador principal* - [clbustos](https://github.com/clbustos)\n\n### Contribuciones\n* **Daniel Lermanda** - Diseñador de página web y asesoría en experiencia de usuario\n* **María Gabriela Morales** - Primera conceptualización y revisión del manual\n* **Liz Medina** -  traducción al inglés de página de inicio y manual.\n* **Alejandro Díaz, Pedro Salcedo**: Desarrollo de requerimientos de usuarios.\n* **Anna Hawrot**: Traducción al Polki (polaco)\n\n\n### Citación\n\nSi usted utiliza este software en su investigación, por favor cite el siguiente paper:\n\nBustos, C., Morales, M.G., Salcedo, P., \u0026 Díaz, Alejandro (2018). Buhos: A web-based systematic literature review management software. SoftwareX, 7, 360-372. [https://doi.org/10.1016/j.softx.2018.10.004](https://doi.org/10.1016/j.softx.2018.10.004)  \n\n## Licencia\n\nEste proyecto está licenciado para la Licencia BSD de 3 cláusulas - vea el archivo [LICENSE](LICENSE) para mayores detalles.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclbustos%2Fbuhos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclbustos%2Fbuhos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclbustos%2Fbuhos/lists"}