<commit_before>![Helios - an extensible open source mobile backend framework](https://raw.github.com/helios-framework/helios.io/assets/helios-banner.png)

Helios is an open-source framework that provides essential backend services for iOS apps, from data synchronization and user accounts to push notifications, in-app purchases, and passbook integration. It allows developers to get a client-server app up-and-running in just a few minutes, and seamlessly incorporate functionality as necessary.

Helios is designed for "mobile first" development. Build out great features on the device, and implement the server-side components as necessary. Pour all of your energy into crafting a great user experience, rather than getting mired down with the backend.

One great example of this philosophy in Helios is Core Data Synchronization. This allows you to use your existing Core Data model definition to automatically generate a REST webservice, which can be used to shuttle data between the server and client. No iCloud, _no problem_.

![Helios Web UI Screenshot](https://raw.github.com/helios-framework/helios.io/assets/helios-screenshot.png)

Helios also comes with a Web UI. Browse and search through all of your database records, push notification registrations, in-app purchases, and passbook passes. You can even send targeted push notifications right from the browser.

---

## Requirements

- Ruby 1.9
- PostgreSQL 9.1 _([Postgres.app](http://postgresapp.com) is the easiest way to get a Postgres server running on your Mac)_

## Getting Started on OS X

1. Verify Ruby Installation

	$ ruby -v
	
	*If you do not see `ruby 1.9.x` printed, we suggest installing [RVM](http://rvm.io) to manage Ruby versions.*
	

2. Install the postgres gem at the command prompt:

	$ gem install pg	

3. Create a postgres database at the command prompt:

	$ createdb myapp_db

4. Install Helios at the command prompt:

    $ gem install helios

5. Create a new Helios application:

    $ helios new myapp
    
6. Change directory to `myapp`

	$ cd myapp
 
   
7. Create a `$DATABASE_URL` environment variable:

	$ export DATABASE_URL=postgres://$USER@localhost/myapp_db
	
	*Note: You can set this in your `.bashrc` or `.bash_profile` if you want to keep it around between terminal sessions.*

8. Start the web server:

    $ helios server

9. Go to [http://localhost:5000/admin](http://localhost:5000/admin) and you’ll see your app's Web UI

Read on for instructions on the following:

- Linking a Core Data model
- Integrating Helios into your mobile client

## Usage
<commit_msg>Updated instructions for setting DATABASE_URL using a .env file.<commit_after>![Helios - an extensible open source mobile backend framework](https://raw.github.com/helios-framework/helios.io/assets/helios-banner.png)

Helios is an open-source framework that provides essential backend services for iOS apps, from data synchronization and user accounts to push notifications, in-app purchases, and passbook integration. It allows developers to get a client-server app up-and-running in just a few minutes, and seamlessly incorporate functionality as necessary.

Helios is designed for "mobile first" development. Build out great features on the device, and implement the server-side components as necessary. Pour all of your energy into crafting a great user experience, rather than getting mired down with the backend.

One great example of this philosophy in Helios is Core Data Synchronization. This allows you to use your existing Core Data model definition to automatically generate a REST webservice, which can be used to shuttle data between the server and client. No iCloud, _no problem_.

![Helios Web UI Screenshot](https://raw.github.com/helios-framework/helios.io/assets/helios-screenshot.png)

Helios also comes with a Web UI. Browse and search through all of your database records, push notification registrations, in-app purchases, and passbook passes. You can even send targeted push notifications right from the browser.

---

## Requirements

- Ruby 1.9
- PostgreSQL 9.1 _([Postgres.app](http://postgresapp.com) is the easiest way to get a Postgres server running on your Mac)_

## Getting Started on OS X

1. Verify Ruby Installation:

	$ ruby -v
	
	*If you do not see `ruby 1.9.x` printed, we suggest installing [RVM](http://rvm.io) to manage Ruby versions.*
	

2. Install the postgres gem at the command prompt:

	$ gem install pg	

3. Create a postgres database at the command prompt:

	$ createdb myapp_db

4. Install Helios at the command prompt:

    $ gem install helios

5. Create a new Helios application:

    $ helios new myapp
    
6. Change directory to `myapp`

	$ cd myapp
 
   
7. Create a `.env` file and specify the database to use. Replace `$USER` with your username.

	$ echo 'DATABASE_URL=postgres://$USER@localhost/myapp_db' >> .env;
	
	*If you don't know your username, simply type `whoami` into your command prompt*

8. Start the web server:

    $ helios server

9. Go to [http://localhost:5000/admin](http://localhost:5000/admin) and you’ll see your app's Web UI

Read on for instructions on the following:

- Linking a Core Data model
- Integrating Helios into your mobile client

## Usage

{'fraction_non_alphanumeric': 0.06936971560338201, 'fraction_numerical': 0.008839354342813221, 'mean_word_length': 4.078048780487805, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '586392', 'n_tokens_mistral': 1489, 'n_tokens_neox': 1410, 'n_words': 690}