Add instructions for installing ocropy into a virtualenv

README.md

@@ -7,13 +7,24 @@ ocropy
 
 Python-based OCR package using recurrent neural networks.
 
-To install, use:
+To install OCRopus dependencies system-wide:
 
     $ sudo apt-get install $(cat PACKAGES)
     $ wget -nd http://www.tmbdev.net/en-default.pyrnn.gz
     $ mv en-default.pyrnn.gz models/
     $ sudo python setup.py install
 
+Alternatively, dependenices can be installed into a [Python Virtual Environment]
+(http://docs.python-guide.org/en/latest/dev/virtualenvs/):
+
+    $ virtualenv ocropus_venv/
+    $ source ocropus_venv/bin/source
+    $ pip install -r requirements_1.txt
+    # tables has some dependencies which must be installed first:
+    $ pip install -r requirements_2.txt
+    $ wget -nd http://www.tmbdev.net/en-default.pyrnn.gz
+    $ mv en-default.pyrnn.gz models/
+
 To test the recognizer, run:
 
     $ ./run-test

ocropus-dewarp

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 import random as pyrandom
 import re

ocropus-econf

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 import warnings,numpy,argparse,sys,os,os.path,multiprocessing,codecs

ocropus-errs

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 import argparse,sys,os,os.path,multiprocessing

ocropus-gpageseg

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 # TODO:
 # ! add option for padding

ocropus-gtedit

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 from pylab import *
 import argparse,codecs,re,os.path,ocrolib,base64

ocropus-hocr

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 import __builtin__ as python
 import random as pyrandom

ocropus-linegen

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 # vim: set fileencoding=utf8 :
 
 import random as pyrandom

ocropus-lpred

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 import random as pyrandom
 import re

ocropus-ltrain

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 import random as pyrandom
 import re

ocropus-nlbin

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 from pylab import *
 from numpy.ctypeslib import ndpointer

ocropus-rpred

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 import traceback
 import codecs

ocropus-rtrain

@@ -1,6 +1,4 @@
-#!/usr/bin/python
-
-#import sys;sys.path.append('/home/tmb/github/ocropy/clstm')
+#!/usr/bin/env python
 
 import random as pyrandom
 import re

ocropus-visualize-results

@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python
 
 import glob
 import matplotlib

requirements_1.txt

@@ -0,0 +1,7 @@
+numpy>=1.9.2
+scipy>=0.15.1
+matplotlib>=1.4.3
+beautifulsoup4>=4.3.2
+numexpr>=2.4
+Cython>=0.22
+Pillow>=2.7.0

requirements_2.txt

@@ -0,0 +1 @@
+tables>=3.1.1