Skip to content
Empirical-Core is our web app for managing students, assigning activities, and viewing results. Core seamlessly incorporates 3rd party applications via the Empirical API.
Ruby JavaScript HTML CSS
Latest commit 8af3fda @ddmck ddmck Merge pull request #1251 from empirical-org/csv_fix
changes email instructions so csv link works
Failed to load latest commit information.
app Merge pull request #1251 from empirical-org/csv_fix
bin Revert "set up environment"
config update V1 Concepts controller for new CMS
db update V1 Concepts controller for new CMS
fixtures/vcr_cassettes fix spec failures related to gem updates and to change in Concept.rb …
lib update demo rake task
log initial
public remove errant images in system
script change admin to staff
spec update V1 Concepts controller for new CMS
vendor/assets more work on activity packs, updated react version
.env-sample move api url into ENV
.gitignore adds rake task, hides pointpin key, fixes bug with zipcodes
.rspec Generate spec_helper.rb & update .rspec
.ruby-gemset relocate csv_loader to lib, rewrite errant shell files as rake tasks,…
.ruby-version fix spec failures related to gem updates and to change in Concept.rb …
.travis.yml update travis ruby version
CONTRIBUTING.md Fix typo in readme
Gemfile Merge pull request #1213 from empirical-org/teacher_ip_location
Gemfile.lock Merge pull request #1213 from empirical-org/teacher_ip_location
Guardfile Guard: run only feature specs if .../pages/* changes
LICENSE.MD Create LICENSE.MD
Procfile sidekiq jobs, serialized content, start/finish activity tracking
README.md change admin to staff
Rakefile cleanup, setup tests
TODO.md Update TODO.md
config.ru Update to rails 4
notes fixed active tabs
runit changes made to app

README.md

Code Climate Test Coverage

Welcome to Empirical Core!

Fork and Clone this repository to submit a Pull Request

Getting Started: Visit our Community Page

CLA: Please register an account & sign our CLA.

The Mailing List, Chat, Issues, and Docs can all be accessed from the community page.

Empirical Easy Install

Here is a guide to Empirical Core that makes installation and setup easy.

If you want a simple guide to install Empirical Core, then you've come to the right place! Here's the step-by-step process to get Empirical Core running on your system:

  1. Download and install rbenv (or a Ruby version manager of your choice). You need to install Ruby version 2.2.2 to properly use Empirical Core. The best way to do this is follow the README and wiki of whatever Ruby version manager you download, but if you decide to use rbenv, then homebrew has a really great and easy-to-use setup and install process:

    1. brew update
    2. brew install rbenv ruby-build
    3. echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
    4. Close and reopen your terminal.
  2. Download and install postgres, the database engine Empirical Core uses. The easiest way to get started with this is to download postgres.app. If you're more comfortable with installing custom software, you can use homebrew to download and install postgres instead:

    1. brew update
    2. brew install postgres
    3. Follow the instructions on the resulting info screen.
  3. Clone the Empirical Core project. Navigate to whatever directory you'd like Empirical Core to live in, and then use git clone https://github.com/empirical-org/Empirical-Core.git. From here on in, all the commands you have to type should be in the new Empirical Core directory you just downloaded, so you should probably cd Empirical-Core.

  4. Install Redis. You can either download it directly, or you can use homebrew instead:

    1. brew update
    2. brew install redis
  5. To run js: true/:js-tagged feature specs, install PhantomJS

  6. Install bundler with gem install bundler

  7. Install the bundle with bundle install.

  8. Set up your database with rake empirical:setup.

  9. Run Redis with redis-server

  10. Run the server with bundle exec rails s.

    • Navigate your browser to localhost:3000 and you should see Empirical-Core pull up properly!
    • When you're done with the server, use Ctrl-C to break it and return to your commandline.
  11. Run bin/guard to have Guard run specs when you save files.

The installation comes with three users, though you can create as many more as you like:

  1. A teacher, username teacher and password teacher.
  2. A student, username student and password student.
  3. An admin, username admin and password admin.
  4. An admin, username staff and password staff.
Something went wrong with that request. Please try again.