Coder Social home page Coder Social logo

hhucn / dbas Goto Github PK

View Code? Open in Web Editor NEW
22.0 8.0 6.0 145.21 MB

Welcome to D-BAS! This is a prototype of our dialog-based argumentation system.

Home Page: https://dbas.cs.uni-duesseldorf.de/

License: MIT License

Python 81.70% Shell 0.50% JavaScript 15.15% Mako 0.02% PLpgSQL 0.10% Dockerfile 0.08% HTML 0.17% Makefile 0.05% Sass 2.23%
argumentation dialog large-scale discussion discussion-platform argument-maps

dbas's Introduction

D-BAS

GitHub release (latest by date)

D-BAS is a novel approach to online argumentation. It avoids the pitfalls of unstructured systems such as asynchronous threaded discussions and it is usable by any participant without training while still supporting the full complexity of real-world argumentation. The key idea is to let users exchange arguments with each other in the form of a time-shifted dialog where arguments are presented and acted upon one-at-a-time.

Currently, the main development-process happens in our GitLab instance, but you can open issues here, submit pull requests etc. and we will coordinate your contributions.

You can play around with the latest release of D-BAS on https://dbas.cs.hhu.de/.

dbas_discussion_image

Setup for Linux / macOS

Ensure that the following tools are installed:

Documentation

Find the latest documentation here: https://dbas.cs.hhu.de/docs/

Environment Variables

D-BAS needs some environment variables to be set for running properly. By default those variables which are required by D-BAS are stored in .env. To get further details on which variables are set or how they can be added/changed take a look at the documentation here.

Compose-Files

All docker-compose.<service>.yml-files had been moved to the /docker/compose folder. Since development.yml is now used for production-mode each <service>.yml-file must be saved separately. To add a service to production-mode the corresponding <service>.yml-file must be defined in /docker/compose. Then the code must be added to docker-compose.yml.

Run D-BAS

Then follow these steps:

If you want to run D-BAS locally in dev-mode:

docker-compose -f docker-compose.dev.yml up

If you want to include the notification service as well as elastic search:

docker-compose -f docker-compose.dev.yml -f docker/compose/notifications.yml -f docker/compose/search.yml up

After this you can hit http://localhost:4284 for D-BAS.

If your container stucks during the first start up, please install D-BAS manually (while the container is running) via:

docker-compose -f docker-compose.dev.yml exec web make

Afterwards everything should be fine.

Production Mode

Currently, the default Compose file is being used by us with pre-built images. We are working on this to make it accessible for everyone.

Start it with:

docker-compose up

Set Ports for your environment in .env or provide it during runtime to your CI/CD platform. Find the variables in .env.

Maintainers

Contributors

We thank all contributors of this project! In order of appearance:

  • Alexander Schneider
  • Marc Feger
  • Markus Brenneis
  • Jan Steimann

Former Contributors

Thanks to all former contributors! In order of appearance:

  • Teresa Uebber (JS Graphs and Visualizations)

Former Maintainers

Thanks for maintaining the project and for your work! We appreciate your efforts 🎉 In order of appearance:

Scientific Background

We published several papers on this work and on our software. Here is a selection of them:

Citations

Cite this software with the BibTeX Scheme:

@inproceedings{hhucn2018,
  title={D-BAS-A Dialog-Based Online Argumentation System.},
  author={Krauthoff, Tobias and Meter, Christian and Baurmann, Michael and Betz, Gregor and Mauve, Martin},
  booktitle={COMMA},
  pages={325--336},
  year={2018}
}

License

Copyright (c) 2016 – 2018 Tobias Schröder (né Krauthoff), Christian Meter
Copyright (c) 2018 – today hhucn

Distributed under the MIT License

dbas's People

Contributors

jaste111 avatar mabre avatar mrebbinghaus avatar n2o avatar phihag avatar rbialon avatar spitzlei avatar tbsschroeder avatar wegi avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

dbas's Issues

Meet with Canonical Debate

I recently ran into this project, and it seems like it might be worthwhile for the people maintaining it to get in touch with what is as far as I know the biggest group of people sharing ideas and discussing systems similar to D-BAS.

The Canonical Debate Lab: https://canonicaldebatelab.com/

We are a bunch of people from both academic and hobby backgrounds working on similar technologies and sharing ideas, trying to work towards a common shared architecture. The Slack group is the most active on this topic that I am aware of, and every now and then we have virtual meetings.

Slack: https://join.slack.com/t/canonicaldebatelab/shared_invite/enQtMzEzOTU3NzYyMDY3LTI4YzUxM2I0MjFjZDNlMzQxZDM4YTgwNDNlMTY3YWQwNjJhYjk0ODE1MGU5NzQ2MTAyNTFhZWRhMGNjMjAxNmE

It would be great to meet someone on this project and give a more detailed presentation on what it is all about and where you want to be headed. :)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.