The WhatsApp lib

Tarek

Last update: Jan 4, 2023

Related tags

Third-party APIs Wrappers yowsup

Overview

yowsup

WARNING

It seems that recently yowsup gets detected during registration resulting in an instant ban for your number right after registering with the code you receive by sms/voice. I'd strongly recommend to not attempt registration through yowsup until I look further into this. Follow the status of this here.

yowsup is a python library that enables building applications that can communicate with WhatsApp users. The project started as the protocol engine behind Wazapp for Meego and OpenWA for BB10. Now as a standalone library it can be used to power any custom WhatsApp client.

updated: 2019-05-07
yowsup version: 3.2.3
yowsup-cli version: 3.2.0
requires:
- python>=2.7,<=3.7
- consonance==0.1.3-1
- python-axolotl==0.2.2
- protobuf>=3.6.0
- six==1.10
uses:
 - argparse [yowsup-cli]
 - readline [yowsup-cli]
 - pillow [send images]
 - tqdm [mediasink demo]
 - requests [mediasink demo]

Quickstart

Installation

Install using setup.py to pull all Python dependencies, or pip:

pip install yowsup

Linux

You need to have installed Python headers (probably from python-dev package) and ncurses-dev, then run

python setup.py install

FreeBSD (*BSD)

You need to have installed: py27-pip-7.1.2(+), py27-sqlite3-2.7.11_7(+), then run

pip install yowsup

Mac OS

python setup.py install

Administrators privileges might be required, if so then run with 'sudo'

Windows

Install mingw compiler
Add mingw to your PATH
In PYTHONPATH\Lib\distutils create a file called distutils.cfg and add these lines:

[build]
compiler=mingw32

Install gcc: mingw-get.exe install gcc
Install zlib
python setup.py install

License:

As of January 1, 2015 yowsup is licensed under the GPLv3+: http://www.gnu.org/licenses/gpl-3.0.html.

Comments

error: C compiler cannot create executable

Describe the bug

I'm using python3 to install the package:
python3 -m pip install yowsup all the related packages gets installed without any problem but when it comes to executing setp.py I get this error mentioned in the title.

Versions Python 3 yowsup latest (not sure which one) appdirs==1.4.4 cffi==1.15.0 consonance==0.1.5 cryptography==36.0.0 dissononce==0.34.3 protobuf==4.0.0rc2 pycparser==2.21 python-axolotl==0.2.2 python-axolotl-curve25519==0.4.1.post2 six==1.10.0 transitions==0.8.10

To Reproduce simply run python3 -m pip install yowsup in the terminal

Expected behavior I expect the package to be installed successfully.

OS (please complete the following information): I'm using MacOS Monterey

Trace of the error

× Building wheel for readline (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [200 lines of output]
      x readline-6.2/
      x readline-6.2/doc/
      x readline-6.2/doc/Makefile.in
      x readline-6.2/doc/texinfo.tex
      x readline-6.2/doc/version.texi
      x readline-6.2/doc/fdl.texi
      x readline-6.2/doc/rlman.texi
      x readline-6.2/doc/rltech.texi
      x readline-6.2/doc/rluser.texi
      x readline-6.2/doc/rluserman.texi
      x readline-6.2/doc/history.texi
      x readline-6.2/doc/hstech.texi
      x readline-6.2/doc/hsuser.texi
      x readline-6.2/doc/readline.3
      x readline-6.2/doc/history.3
      x readline-6.2/doc/texi2dvi
      x readline-6.2/doc/texi2html
      x readline-6.2/doc/readline.ps
      x readline-6.2/doc/history.ps
      x readline-6.2/doc/rluserman.ps
      x readline-6.2/doc/readline.dvi
      x readline-6.2/doc/history.dvi
      x readline-6.2/doc/rluserman.dvi
      x readline-6.2/doc/readline.info
      x readline-6.2/doc/history.info
      x readline-6.2/doc/rluserman.info
      x readline-6.2/doc/readline.html
      x readline-6.2/doc/history.html
      x readline-6.2/doc/rluserman.html
      x readline-6.2/doc/readline.0
      x readline-6.2/doc/history.0
      x readline-6.2/doc/readline_3.ps
      x readline-6.2/doc/history_3.ps
      x readline-6.2/doc/history.pdf
      x readline-6.2/doc/readline.pdf
      x readline-6.2/doc/rluserman.pdf
      x readline-6.2/examples/
      x readline-6.2/examples/autoconf/
      x readline-6.2/examples/autoconf/BASH_CHECK_LIB_TERMCAP
      x readline-6.2/examples/autoconf/RL_LIB_READLINE_VERSION
      x readline-6.2/examples/autoconf/wi_LIB_READLINE
      x readline-6.2/examples/rlfe/
      x readline-6.2/examples/rlfe/ChangeLog
      x readline-6.2/examples/rlfe/Makefile.in
      x readline-6.2/examples/rlfe/README
      x readline-6.2/examples/rlfe/config.h.in
      x readline-6.2/examples/rlfe/configure
      x readline-6.2/examples/rlfe/configure.in
      x readline-6.2/examples/rlfe/extern.h
      x readline-6.2/examples/rlfe/os.h
      x readline-6.2/examples/rlfe/pty.c
      x readline-6.2/examples/rlfe/rlfe.c
      x readline-6.2/examples/rlfe/screen.h
      x readline-6.2/examples/Makefile.in
      x readline-6.2/examples/excallback.c
      x readline-6.2/examples/fileman.c
      x readline-6.2/examples/manexamp.c
      x readline-6.2/examples/readlinebuf.h
      x readline-6.2/examples/rl-fgets.c
      x readline-6.2/examples/rlcat.c
      x readline-6.2/examples/rlevent.c
      x readline-6.2/examples/rltest.c
      x readline-6.2/examples/rl.c
      x readline-6.2/examples/rlptytest.c
      x readline-6.2/examples/rlversion.c
      x readline-6.2/examples/histexamp.c
      x readline-6.2/examples/Inputrc
      x readline-6.2/examples/rlwrap-0.30.tar.gz
      x readline-6.2/support/
      x readline-6.2/support/config.guess
      x readline-6.2/support/config.rpath
      x readline-6.2/support/config.sub
      x readline-6.2/support/install.sh
      x readline-6.2/support/mkdirs
      x readline-6.2/support/mkdist
      x readline-6.2/support/mkinstalldirs
      x readline-6.2/support/shobj-conf
      x readline-6.2/support/shlib-install
      x readline-6.2/support/wcwidth.c
      x readline-6.2/shlib/
      x readline-6.2/shlib/Makefile.in
      x readline-6.2/COPYING
      x readline-6.2/README
      x readline-6.2/MANIFEST
      x readline-6.2/INSTALL
      x readline-6.2/CHANGELOG
      x readline-6.2/CHANGES
      x readline-6.2/NEWS
      x readline-6.2/USAGE
      x readline-6.2/aclocal.m4
      x readline-6.2/config.h.in
      x readline-6.2/configure
      x readline-6.2/configure.in
      x readline-6.2/Makefile.in
      x readline-6.2/ansi_stdlib.h
      x readline-6.2/chardefs.h
      x readline-6.2/history.h
      x readline-6.2/histlib.h
      x readline-6.2/keymaps.h
      x readline-6.2/posixdir.h
      x readline-6.2/posixjmp.h
      x readline-6.2/readline.h
      x readline-6.2/posixselect.h
      x readline-6.2/posixstat.h
      x readline-6.2/rlconf.h
      x readline-6.2/rldefs.h
      x readline-6.2/rlmbutil.h
      x readline-6.2/rlprivate.h
      x readline-6.2/rlshell.h
      x readline-6.2/rlstdc.h
      x readline-6.2/rltty.h
      x readline-6.2/rltypedefs.h
      x readline-6.2/rlwinsize.h
      x readline-6.2/tcap.h
      x readline-6.2/tilde.h
      x readline-6.2/xmalloc.h
      x readline-6.2/bind.c
      x readline-6.2/callback.c
      x readline-6.2/compat.c
      x readline-6.2/complete.c
      x readline-6.2/display.c
      x readline-6.2/emacs_keymap.c
      x readline-6.2/funmap.c
      x readline-6.2/input.c
      x readline-6.2/isearch.c
      x readline-6.2/keymaps.c
      x readline-6.2/kill.c
      x readline-6.2/macro.c
      x readline-6.2/mbutil.c
      x readline-6.2/misc.c
      x readline-6.2/nls.c
      x readline-6.2/parens.c
      x readline-6.2/readline.c
      x readline-6.2/rltty.c
      x readline-6.2/savestring.c
      x readline-6.2/search.c
      x readline-6.2/shell.c
      x readline-6.2/signals.c
      x readline-6.2/terminal.c
      x readline-6.2/text.c
      x readline-6.2/tilde.c
      x readline-6.2/undo.c
      x readline-6.2/util.c
      x readline-6.2/vi_keymap.c
      x readline-6.2/vi_mode.c
      x readline-6.2/xfree.c
      x readline-6.2/xmalloc.c
      x readline-6.2/history.c
      x readline-6.2/histexpand.c
      x readline-6.2/histfile.c
      x readline-6.2/histsearch.c
      x readline-6.2/patchlevel
      patching file vi_mode.c
      patching file callback.c
      patching file support/shobj-conf
      patching file patchlevel
      patching file input.c
      patching file patchlevel
      patching file vi_mode.c
      patching file patchlevel
      checking build system type... i386-apple-darwin21.1.0
      checking host system type... i386-apple-darwin21.1.0
      
      Beginning configuration for readline-6.2 for i386-apple-darwin21.1.0
      
      checking whether make sets $(MAKE)... yes
      checking for gcc... gcc
      checking for C compiler default output file name...
      configure: error: in `/private/var/folders/58/qpd8_j7j3w7djctktt4v4ym00000gn/T/pip-install-557lmep9/readline_bf34c6d3fd7b4517afc54ced2885e496/rl/readline-lib':
      configure: error: C compiler cannot create executables
      See `config.log' for more details.
      /private/var/folders/58/qpd8_j7j3w7djctktt4v4ym00000gn/T/pip-build-env-pwo19g8a/overlay/lib/python3.9/site-packages/setuptools/dist.py:770: UserWarning: Usage of dash-separated 'multi-version' will not be supported in future versions. Please use the underscore name 'multi_version' instead
        warnings.warn(
      
      ============ Building the readline library ============
      
      
      ============ Building the readline extension module ============
      
      running bdist_wheel
      running build
      running build_ext
      building 'readline' extension
      creating build
      creating build/temp.macosx-10.14-x86_64-cpython-39
      creating build/temp.macosx-10.14-x86_64-cpython-39/Modules
      creating build/temp.macosx-10.14-x86_64-cpython-39/Modules/3.x
      clang -Wno-unused-result -Wsign-compare -Wunreachable-code -fno-common -dynamic -DNDEBUG -g -fwrapv -O3 -Wall -I/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/usr/include -I/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/System/Library/Frameworks/Tk.framework/Versions/8.5/Headers -DHAVE_RL_CALLBACK -DHAVE_RL_CATCH_SIGNAL -DHAVE_RL_COMPLETION_APPEND_CHARACTER -DHAVE_RL_COMPLETION_DISPLAY_MATCHES_HOOK -DHAVE_RL_COMPLETION_MATCHES -DHAVE_RL_COMPLETION_SUPPRESS_APPEND -DHAVE_RL_PRE_INPUT_HOOK -I. -I/Users/mac/Documents/Workspace/mdata-one/backend/trying-yowsup/.venv/include -I/usr/local/opt/[email protected]/Frameworks/Python.framework/Versions/3.9/include/python3.9 -c Modules/3.x/readline.c -o build/temp.macosx-10.14-x86_64-cpython-39/Modules/3.x/readline.o -Wno-strict-prototypes
      Modules/3.x/readline.c:842:19: warning: initializing 'char *' with an expression of type 'const char *' discards qualifiers [-Wincompatible-pointer-types-discards-qualifiers]
                  char *s = _PyUnicode_AsString(r);
                        ^   ~~~~~~~~~~~~~~~~~~~~~~
      Modules/3.x/readline.c:1179:34: warning: incompatible function pointer types assigning to 'char *(*)(FILE *, FILE *, const char *)' (aka 'char *(*)(struct __sFILE *, struct __sFILE *, const char *)') from 'char *(FILE *, FILE *, char *)' (aka 'char *(struct __sFILE *, struct __sFILE *, char *)') [-Wincompatible-function-pointer-types]
          PyOS_ReadlineFunctionPointer = call_readline;
                                       ^ ~~~~~~~~~~~~~
      2 warnings generated.
      creating build/lib.macosx-10.14-x86_64-cpython-39
      clang -bundle -undefined dynamic_lookup build/temp.macosx-10.14-x86_64-cpython-39/Modules/3.x/readline.o readline/libreadline.a readline/libhistory.a -lncurses -o build/lib.macosx-10.14-x86_64-cpython-39/readline.cpython-39-darwin.so
      clang: error: no such file or directory: 'readline/libreadline.a'
      clang: error: no such file or directory: 'readline/libhistory.a'
      error: command '/usr/bin/clang' failed with exit code 1
      [end of output]
  
  note: This error originates from a subprocess, and is likely not a problem with pip.
  ERROR: Failed building wheel for readline
Failed to build readline
ERROR: Could not build wheels for readline, which is required to install pyproject.toml-based projects

opened by SlimenTN 0

tctoken for last seen

Hello, I found a way to get the tctoken of the number to follow to run the last seen feature, but I couldn't get it to work in yowsup. How can I activate tctoken on yowsup?

opened by mehmetmyuce 4
endpoints

Hello, how are you, what I was able to analyze by testing the code and debugging, is that you don't have access with socket and endpoints, I don't know if they have changed the port or some additional information, anyway I will continue debugging

opened by Rodrigosolari 2
Last Presence not working (lastseen) doesnt work

Last presence (/contact lastseen number (jid) I get: No response

I noticed jabber:iq:last is outdated? i cant find it in new whatsapp versions Anyone found a workaround

opened by BigSleazy1 0
lots of accounts banned again.

On 1Nov2022, lots of accounts were banned. Today, lots of accounts were banned again from 8Dec2022 5pm US time. Does anyone have the same issue?

The error message: <failure vt="15" reason="403" location="vll"

opened by OVERSKY2003 2

Releases(v3.3.0)

v3.3.0(Dec 14, 2021)
Updated to whatsapp protocol 4.0

Updated consonance to 0.1.5

Fixed registration error due to obsolete keys in returned data

Updated android env app version to 2.21.21.18

Source code(tar.gz)
Source code(zip)
v3.1.0(Apr 24, 2019)
v3.1.0

Network layer prevents createConnection if already connected

Fixed crash when config path does not exist

yowsup-cli will interpret -c as phone if load_path fails

Allow keypair in credentials to be bytes

Noise layer now uses credential's client_static_keypair if set, instead of loading it from stored config

Improved config type detection logic, refs #2664

Fixed some python2-related problems (long-type phone numbers, missing list.clear() method), refs #2664

Updated consonance to fix dissononce's machine.next and enforce cryptography>=0.25

Fixed some demos not shutting down properly

Added complete asyncore dispatcher implementation.

Added support for decoding deflate compressed data, fixes #2671

Allow Specifying a connection dispatcher (asyncore/socket) using YowNetworkLayer.PROP_DISPATCHER

Added --layer-network-dispatcher to cli demos

Removed threading from socket dispatcher, connecting application should ensure the connection is not blocking, for example by triggering connect in a bg thread.

Source code(tar.gz)
Source code(zip)
v3.0.0(Apr 23, 2019)
Changed

Changed default env to android

Updated whatsapp version in env to 2.19.51

Updated logs formatting to be more compact

Changed storage dir on linux to ~/.config/yowsup

yowsup-cli -p is now used for preview requests rather than specifying phone number

Decoupled Axolotl management from Axolotl layer

Fixed Python3.7 support

Updated device details in Env to be of Samsung S9+

Changed generated signed prekeys ids to be sequential

Fixed some notifications getting redundant acks

Fixed outgoing ack in a group now requiring participant to be specified

Added

WhatsApp Protocol 2.1 support

Noise layer

Login using Consonance; a new dependency

New Registration parameters

Encryption of registration parameters

Auto saving of Config at registration

Log which endpoint we are connecting to

Support superadmin and multiple admins in group create notification

Better Config management and JSON config files support

AxolotlManager

Any Config property overriding in yowsup-cli

yowsup-cli config

yowsup-cli --log-dissononce

yowsup-cli --log-dissononce

Preview only registration and other http requests

Removed

Optional axolotl/e2e enc enabling, it's now forced.

S40 env

Password from Config

Outdated http parameters in registration

TimeTools along with python-dateutil dependency.

Source code(tar.gz)
Source code(zip)
v2.5.2(Mar 23, 2017)
Fixed xml-not-well-formed when data is sent from multiple threads simultaneously

Updated S40 env, thanks to @Mailaender

Source code(tar.gz)
Source code(zip)
v2.5.0(May 22, 2016)
v2.5.0

Core

Fixed python 2.6 support

Auto-reconnect on stream:error

Allow autotrust changed identities via an exposed layer property

Fixed block detection in exists request, initiated by code request

Fixed crash when node data is string

Protocol

WA1.6 support

Fully working group encryption support

Updated s40 token to 2.16.7

Fixed timestamp in authentication not being UTC

Fixed handling variant decrypt/encr fail scenarios

Known issues

No support for encrypted media yet

Source code(tar.gz)
Source code(zip)
v2.4.102(Apr 1, 2016)
Simpler env select using YowsupEnv.setEnv("env_name"), get using YowsupEnv.getCurrent()

yowsup-cli allows setting preferred env using -E/--env argument

Source code(tar.gz)
Source code(zip)
v2.4.48(Dec 14, 2015)
Core

Fixed bug that avoid some acks from being sent, thanks to @t0rr3sp3dr0

Check fields in video message before parsing, thanks to @Menachem

Fixed image scaling in Palette mode, thanks to @janboll and @Salmon-Bard

Fixed image preview, thanks to @gagandeep

Fixed erroneous method in LiteAxolotlStore, thanks to @magicgoose

Fixed YowParallelLayer returning layer instead of the layer's interface

Protocol

Can now get status of users, thanks to @moyamo

Fixed login, thanks to @cgraefe

new profile privacy options, thanks to @jlguardi

Registration

Updated registration token, thanks to @mgp25

Updated android env data, thanks to @Holi0317

yowsup-cli demos

Send read receipts for received messages in cli demo, thanks to @jlguardi

Fixed Warning that demos are not using YowParallelLayer, thanks to @joaoricardo000

Source code(tar.gz)
Source code(zip)
v2.4(Sep 6, 2015)
Mostly core updates, and most importantly is the ability for a layer to expose an Interface for direct interaction from other layers/places. For example, doing a yowNetworkLayerInterface.connect() makes more sense than broadcasting an event across all other irrelevant layers. Or a storage layer that saves incoming and outgoing messages, and then a GUI which would like to query a conversation history would request the storage layer's interface which should expose methods like "getMessages"

Changes:

Protocol

Support sending receipt for multiple messages

Updated S40 env to 2.12.96

Core

Layers can now expose an InterfaceLayer for outside interaction

YowNetworkLayer and Auth Layer now expose an InterfaceLayer

Fixed message forwarding thanks to @jlguardi

Don't panic on try send something when offline

Allow setting props on stackbuilder, it passed them to the instantiated stack

Fixed interface not forwarding to upper layers unhandled protocolenties

Don't crash on UntrustedIdentityException, will silently ignore the message

Handle DuplicateMessageException

Added stack.send/receive

Cli

E2E enc is now enabled by default, remove -m/--moxie switch

Opt-out E2E enc using -M/--unmoxie

Source code(tar.gz)
Source code(zip)
v2.3.185(Aug 1, 2015)
Protocol

Recover from possible no session/no prekey in a received message, thanks to @danielapsmaior

Send/receive v2 enc messages, thanks to @CharlesOkwuagwu

Source code(tar.gz)
Source code(zip)
v2.3.183(Jul 27, 2015)

Core:

random endpoints selection, thanks to @jlguardi

Protocol:

Handle account ib Fixed audio send

Demos:

improved cli demo usage display, thanks to @jlguardi added /audio send to cli demo support for image caption in cli demo, thanks to @jlguardi
Source code(tar.gz)
Source code(zip)
v2.3.167(Jul 21, 2015)

Core

Updated to e16 serv Fixed callbacks for group info iq Use s40 env by default Updated to s40 v2.12.189 Fixed error in android env with python 2.6, thanks to Alexander Bergolth

Protocol

Removed "av" from enc nodes Added contact sync notification

yowsup-cli

Deprecated --moxie Optional arguments support in yowsup demo, thanks to @jlguardi Fixed error when axolotl is not installed
Source code(tar.gz)
Source code(zip)
v2.3.123(Jun 22, 2015)
Core:

Create an ack or a forwarded message directly from receipt message, thanks to @jlguardi Allow getting Id of set profile picture, thanks to @aesedepece Some code clean ups, thanks to @emamirazavi Fixed set status and set picture not triggering callbacks

Protocol:

Get contact's last seen time

Handle multiple items in receipt, thanks to Bram

Notifications for participants add,remove in a group thanks to Bram and @jlguardi

Receipts from participants in a group, thanks to Bram

Promote,demote participants and rest of groups version 2 support, thanks to @jlguardi

Demos:

New contacts sync demo, thanks to @girish946

New groups commands: /group promote, /group demote thanks to @jlguardi

New contacts commands: /contact lastseen

Source code(tar.gz)
Source code(zip)
v2.3.84(May 26, 2015)

Core:

Allow specifying ping interval, thanks to @Cataractar Connect behind http proxy support, thanks to @dinhoabreu

Protocol:

Updated s40 tokens Updated android token, thanks to @dedmen Audio and video receive support, thanks to @aesedepece Fixed receive presence, thanks to @aesedepece Get contact's profile picture, thanks to @aesedepece Handle calls, thanks to @aesedepece Fixed ack errors, thanks to @aguiraf Propagate StreamFeaturesProtocolEntity to upper layers, thanks to @ant9000 Fixes to incoming receipt, thanks to @prasselpikachu Group info v2, thanks to @ant9000 Don't stream error on web notifications, thanks to @aesedepece

Demos:

Fixed keys_get in cli demo, thanks to @tvandergeer Fixed invite to group in cli demo Added kick from group in cli demo
Source code(tar.gz)
Source code(zip)
v2.2.78(Feb 17, 2015)

Core:

Fixed problem reading identity which caused reg error Keep connection alive through perioding pinging, thanks to @galmeida Fixed compatibility with the whole python 2.6-3.4 spectrum Added StackBuilder to make stack construction easier

Protocol:

Distinguish received delivered and read receipt, thanks to @NickCis Fixed leave groups, thanks to @[email protected] Added Profile Layer Add participants to a group, thanks to @emamirazavi Fixes to registration, thanks to @aesedepece Updated S40 registration token Save next challenge and use in next auth, thanks to @samiexa Get contact profile picture, thanks to Jamie Gloudon

yowsup-cli and demos:

Fixed groups jid handling in sendclient, thanks to @fire855 Fixed readline redundant dependency in linux, thanks to @NickCis Added group_invite in cli demo to add participants to a group, thanks to @emamirazavi Added leave_group to cli demo
Source code(tar.gz)
Source code(zip)
v2.2.15(Jan 12, 2015)
The update brings support for End-to-End encryption newly introduced in WhatsApp's Android clients (AKA Axolotl) (AKA Textsecure).

New Dependencies:

python-axolotl

pillow

General:

As of January 2015, Yowsup is GPLv3 licensed (previouly was MIT)

Protocol Specific:

Experimental Axolotl support (end-to-end encryption)

Upload and send images

Fixed broadcast (thanks to @mgp25)

Fixed registration no_routes error

Initial support for groups v2

Core:

Easy switch/ add new enviornment (S40/Android ..etc)

Added _sendIq in YowProtocolLayer and YowInterfaceLayer with callbacks for Iq result and error

Updated registration token

yowsup-cli/demos:

Added new send and exit demo

Added E2E encryption in yowsup and echo client demos

Added image_send to yowsup demo

Source code(tar.gz)
Source code(zip)
v2.0.53(Dec 15, 2014)
Protocol Specific:

Upgraded to WA 1.5

Fixed previews in images

Pass pongs to upper layers

Add chatstate support (typing/ paused), thanks to @galmeida

Added support for send/recv location, thanks to @felix-dumit

Added support for send/recv vcards, thanks to @uelhav

Added potential fix for not receiving registratio sms

Ack notifications

Core:

Write date to socket as they come, thanks to @galmeida

Parallels layers now get events sent by siblings

Broadcast event on login

yowsup-cli/ demos:

Added send typing/paused state to cli demo

Echo demo now echoes images, thanks to @felix-dumit

Echo demo now echoes vcards, thanks to @uelhav

Fixed readline/pyreadline dependency problem

Source code(tar.gz)
Source code(zip)