Skip to main content

magpie: [ma]rkdown, [g]it, [pie]thon

Project description

magpie: [ma]rkdown, [g]it, [pie]thon

Git-backed Evernote replacement



(outside of PyPI):

  • Python
  • Pip/Easy Install
  • Git

Installing magpie

pip install magpie

Setup Git Repo

git init


mkdir -p /path/to/notes/repo/
cd /path/to/notes/repo/
git init

On Github

On Bitbucket

git config

Depending on what your environment is like, you may get a nasty error the first time you try to do something useful. This happened to me when I setup magpie to work with supervisor. In order to resolve this, I had to set the and fields in git config. The error message on the magpie page will tell you the syntax.

Launch magpie



In browser, go to http://localhost:8080


On the main page, there should be a link to configure magpie. (Alternatively, http://localhost:8080/config)

Enter as much info here as you want. Username / Password are not required, but recommended. The only required field is repo. The path from “Init Git Repo” above should be entered here.

What is magpie?

I love Evernote, but I no longer trust my data to cloud providers. Magpie is an attempt to make a reasonably sufficient Evernote replacement where the users control their data.

Basically, magpie is just a web tool for managing text files in a git repo. In it, you can create notebooks (which are just folders); create, edit, and delete notes (which are just files). That’s pretty much it. However, when you make any of these changes, they are automatically committed to git.

What isn’t magpie?

  • Complete (see contributing)
  • Secure (magpie is only as safe as you make it. If your git repo is hosted on a public server, people will be able to read your notes. If you run it on an open network, people may be able to access your notes. Etc.)
  • Shiny (This is a side project written and maintained - so far - by a single person. It’s never going to be as good or as useable as Evernote.)


  • Markdown & HTML notes are rendered on the page

  • Uses git as a backend

    • Easy backups (if you know git): clone once, then push/pull to backup notes
    • track history, etc, just like with git (using git, not via magpie’s web interface … yet?)
  • Render “[ ]” and “[x]” as check boxes. Clicking them changes and saves the note.

  • Email yourself notes (see emailing notes)

  • Scrape PDFs to make them searchable in magpie (see pdf_scraper)

Image Attribution

Logo/favicon courtesy of Kieran Palmer, as licensed under CC BY-SA 2.0 Generic.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
magpie-0.0.1.tar.gz (55.9 kB) Copy SHA256 hash SHA256 Source None Jun 10, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page