Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cozy/cozy

Simple, Versatile, Yours
https://github.com/cozy/cozy

Last synced: 2 months ago
JSON representation

Simple, Versatile, Yours

Awesome Lists containing this project

README 

        
# Cozy - Simple, Versatile, Yours



![Cozy Logo](https://raw.githubusercontent.com/cozy/cozy-setup/gh-pages/assets/images/happycloud.png)



:warning: __This repository is no longer maintained. It was the first version of the Cozy personal cloud server. We are actively developping a new, improved, version: Cozy V3. You can follow the development [here](https://github.com/cozy/cozy-stack), to test it and report bugs.__



Cozy is an app-based personal cloud you host at home. It turns a low-cost piece

of hardware like a Raspberry Pi 2 or an online VPS into a powerful app

platform. It comes with common applications: a contacts manager, a calendar, a

webmail and a filebox. An Android app allows you to sync your contacts,

calendars and files with your mobile. Last but not least, the Cozy Community

has built many personal tools like a feed reader, a bank operation

manager or an IRC client (100 000 apps were downloaded in 2015).



Cozy is based on Node.js and allows realtime interaction between apps. Any app

can request access to other application data. That way apps can communicate

and share information.



Website: https://cozy.io



[![Cozy Home screenshot](https://docs.cozy.io/assets/press/screenshots/home_th.png)](https://docs.cozy.io/assets/press/screenshots/home.png)

[![Cozy Contacts screenshot](https://docs.cozy.io/assets/press/screenshots/contacts_th.png)](https://docs.cozy.io/assets/press/screenshots/contacts.png)

[![Cozy Emails screenshot](https://docs.cozy.io/assets/press/screenshots/emails_th.png)](https://docs.cozy.io/assets/press/screenshots/emails.png)

[![Cozy Calendar screenshot](https://docs.cozy.io/assets/press/screenshots/calendar_th.png)](https://docs.cozy.io/assets/press/screenshots/calendar.png)

[![Cozy Files screenshot](https://docs.cozy.io/assets/press/screenshots/files_th.png)](https://docs.cozy.io/assets/press/screenshots/files.png)



### Main Benefits



* A smoother experience of your digital life

* Ownership of your data and respected privacy

* Vendor-agnostic synchronization

* Quick start with Google data importer (contacts and calendars)

* Playground for developers to build new apps around personal data



## Install



There are many ways to install Cozy:



* [Through Debian repository](https://docs.cozy.io/en/host/install/install-on-debian.html) ([repo](https://github.com/cozy/cozy-debian))

* [Via the Raspberry Pi 2 Image](https://docs.cozy.io/en/host/install/install-on-raspberry.html)

* [Via Docker](https://docs.cozy.io/en/host/install/install-on-docker.html) ([repo](https://github.com/cozy-labs/cozy-docker))

* [All methods](https://docs.cozy.io/en/host/install/)



## Community



We have a vibrant community that will be glad to welcome you. You can share

with us your thoughts, your feedback, bug reports or app ideas. 



*NB: The community is composed mainly of French users, but don't be afraid they

can speak English too!*



* [Forum](https://forum.cozy.io)

* [Wiki](https://github.com/cozy/cozy-setup/wiki)

* [Twitter](https://twitter.com/mycozycloud)

* [Github](https://github.com/cozy)

* [Labs on Github](https://github.com/cozy-labs)

* Chat: #cozycloud on irc.freenode.net



### Translators



Like many free and open source projects, you can contribute by translating 

the user interface texts. To manage this, we use the Transifex platform. Cozy

is already translated into English, French, German and Spanish. If you want to

add your own language, connect with us via our [Transifex

Dashboard](https://www.transifex.com/organization/cozy)!



### Developers



Building an app for Cozy is the fastest way to learn full stack development

with Node.js. We propose [a complete

Tutorial](https://dev.cozy.io/) that will teach you how to

use Express.js and AngularJS to build your first Single Page Application.



For experimented web developers you can use the frameworks you want. The only

requirement is to use the [Cozy database driver](https://github.com/cozy/cozydb).



Whatever your skill level, we propose a [Mentorship Program](https://forum.cozy.io/t/mentorship-program/529). 

A member of the Cozy Team will be there to as you build your Cozy app. Feel free to sign up via the forum.



#### Benefits for developers



* Learn full-stack development with Node.js

* Experiment and quickly build prototypes for your next app

* Avoid the pain of deployment and user administration

* Give yourself tools that let you control your own data

* Share your app and get feedback from the Cozy Community



#### Connectors



Alternatively, there is Konnectors, an app that will enable you to fetch data from numerous vendors. 

It's easier to build a connector than write an app. Look at the

[Konnectors](https://github.com/cozy-labs/konnectors) repository for more

information.



### Platform maintenance



You will find here every open tickets and pull request for the Cozy platform:



* [Bug List](https://github.com/issues?q=is%3Aopen+is%3Aissue+user%3Acozy+label%3Abug+-repo%3Acozy%2Ftodos+-repo%3Acozy%2Fnotes+-repo%3Acozy%2Fcozy-editor+)

* [Feature Request List](https://github.com/issues?q=is%3Aopen+is%3Aissue+user%3Acozy+label%3Aenhancement+-repo%3Acozy%2Ftodos+-repo%3Acozy%2Fnotes+-repo%3Acozy%2Fcozy-editor+)

* [Opened Pull Requests](https://github.com/pulls?user=cozy)

* [Waiting tickets](https://github.com/issues?q=is%3Aopen+is%3Aissue+user%3Acozy+no%3Alabel+-repo%3Acozy%2Fcozy-guidelines)

* [Tickets good for a first contribution](https://github.com/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+user%3Acozy+label%3A%22Good+For+First+Contribution%22+-repo%3Acozy%2Ftodos+-repo%3Acozy%2Fnotes+-repo%3Acozy%2Fcozy-editor+)



## Architecture



Below is a quick overview of the architecture. You can find more details 

[here](https://docs.cozy.io/en/hack/getting-started/architecture-overview.html).



![Architecture diagram](https://docs.cozy.io/assets/images/architecture-overview.svg)



## License



Cozy is developed by Cozy Cloud under the AGPL v3 license (see each module for

exceptions).