--- /dev/null
+===============
+sid an xmpp bot
+===============
+
+Getting sid
+------------
+
+Currently unreleased, only a development version is available.
+
+ http://git.kaliko.me/?p=sid.git
+
+Getting the latest source code
+------------------------------
+
+If you would instead like to use the latest source code, you can grab a copy
+of the development version from git by running the command:
+
+ git clone git://git.kaliko.me/sid.git
+
+
+Installing from source
+----------------------
+
+To install sid from source, simply run the command (within a virtualenv preferably)::
+
+ python3 setup.py install
+
+You can use the `--help` switch to `setup.py` for a complete list of commands
+and their options. See the `Installing Python Modules`_ document for more details.
+
+
+Using the bot
+-------------
+
+Here is a plain example::
+
+ #!/usr/bin/env python3
+ # -*- coding: utf-8 -*-
+
+ import getpass
+ from sid.sid import MUCBot
+ from sid.ping import Ping
+
+ JID = 'bot@example.org'
+ NICK = 'sid'
+ PASS = getpass.getpass('Password for "{}": '.format(JID))
+ ROOM = 'room@conf.example.org'
+
+ xmpp = MUCBot(JID, PASS, ROOM, NICK)
+ xmpp.register_bot_plugin(Ping)
+ # Connect to the XMPP server and start processing XMPP stanzas.
+ if xmpp.connect():
+ xmpp.process(block=True)
+ xmpp.shutdown_plugins()
+ xmpp.log.info('Done')
+ else:
+ xmpp.log.info('Unable to connect.')
+
+
+Contacting authors
+------------------
+
+The current maintainer can be found on xmpp chat room <kaliko.me⊘conf.azylum.org>
+or you can contact him by email/xmpp <kaliko⊘azylum.org>.
+
+ .. _Installing Python Modules: http://docs.python.org/3/install/
+
--- /dev/null
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+from setuptools import setup, find_packages
+
+from sid import __version__, __url__, __author__, __email__
+
+setup(
+ name='sid',
+ author = __author__,
+ author_email = __email__,
+ version=__version__,
+ download_url=__url__,
+ packages=find_packages(),
+ install_requires=['sleekxmpp>=1.3.0'],
+ description="An xmpp bot based on sleekxmpp",
+ license='GPL-3',
+ keywords = "xmpp bot",
+
+)
+
+# VIM MODLINE
+# vim: ai ts=4 sw=4 sts=4 expandtab