# pyfa

[](https://p
yfainvite.azurewebsites.net/) [![Build Status](https://travis-ci.org/pyfa-org/Py
fa.svg?branch=master)](https://travis-ci.org/pyfa-org/Pyfa)
![pyfa](https://cloud.githubusercontent.com/assets/3904767/10271512/af385ef2-6ad
e-11e5-8f67-52b8b1e4c797.PNG)
## What is it?
pyfa, short for **py**thon **f**itting **a**ssistant, allows you to create, expe
riment with, and save ship fittings without being in game. Open source and writt
en in Python, it is available on any platform where Python 2.x and wxWidgets are
available, including Windows, Mac OS X, and Linux.
## Latest Version and Changelogs
The latest version along with release notes can always be found on the project's
[Releases](https://github.com/DarkFenX/Pyfa/releases) page. pyfa will notify yo
u if you are running an outdated version.
## Installation
Windows and OS X users are supplied self-contained builds of pyfa on the [latest
releases](https://github.com/pyfa-org/Pyfa/releases/latest) page. An `.exe` ins
taller is also available for Windows builds. Linux users can run pyfa using thei
r distribution's Python interpreter. There is no official self-contained package
for Linux, however, there are a number of third-party packages available throug
h distribution-specific repositories.
#### OS X
There are two different distributives for OS X: `-mac` and `-mac-deprecated`.
* `-mac`: based on wxPython 3.0.2.0 and has updated libraries. This is the recom
mended build.
* `-mac-deprecated`: utilizes older binaries running on wxPython 2.8; because of
this, some features are not available (currently CREST support and Attribute Ov
errides). Additionally, as development happens primarily on wxPython 3.0, a few
GUI bugs may pop up as `-mac-deprecated` is not actively tested. However, due to
some general issues with wxPython 3.0, especially on some newer OS X versions,
`-mac-deprecated` is still offered for those that need it.
There is also a [Homebrew](http://brew.sh) option for installing pyfa on OS X. P
lease note this is maintained by a third-party and is not tested by pyfa develop
ers. Simply fire up in terminal:
```
$ brew install Caskroom/cask/pyfa
```
### Linux Distro-specific Packages
The following is a list of pyfa packages available for certain distributions. Pl
ease note that these packages are maintained by third-parties and are not evalua
ted by the pyfa developers.
* Debian/Ubuntu/derivitives: https://github.com/AdamMajer/Pyfa/releases
* Arch: https://aur.archlinux.org/packages/pyfa/
* openSUSE: https://build.opensuse.org/package/show/home:rmk2/pyfa
* FreeBSD: http://www.freshports.org/games/pyfa/ (see [#484](https://github.com/
pyfa-org/Pyfa/issues/484) for instructions)
### Dependencies
If you wish to help with development or simply need to run pyfa through a Python
interpreter, the following software is required:
* Python 2.7
* `wxPython` 2.8/3.0
* `sqlalchemy` >= 1.0.5
* `dateutil`
* `matplotlib` (for some Linux distributions you may need to install separate wx
Python bindings such as `python-matplotlib-wx`)
* `requests`
## Bug Reporting
The preferred method of reporting bugs is through the project's [GitHub Issues i
nterface](https://github.com/pyfa-org/Pyfa/issues). Alternatively, posting a rep
ort in the [pyfa thread](http://forums.eveonline.com/default.aspx?g=posts&t=2476
09) on the official EVE Online forums is acceptable. Guidelines for bug reportin
g can be found on [this wiki page](https://github.com/DarkFenX/Pyfa/wiki/Bug-Rep
orting).
## License
pyfa is licensed under the GNU GPL v3.0, see LICENSE
## Resources
* Development repository: [https://github.com/pyfa-org/Pyfa](https://github.com/
pyfa-org/Pyfa)
* XMPP conference: [pyfa@conference.jabber.org](pyfa@conference.jabber.org)
* [EVE forum thread](http://forums.eveonline.com/default.aspx?g=posts&t=247609)
* [EVE University guide using pyfa](http://wiki.eveuniversity.org/Guide_to_using
_PYFA)
* [EVE Online website](http://www.eveonline.com/)
## Contacts:
* Sable Blitzmann
* GitHub: @blitzmann
* [TweetFleet Slack](https://www.fuzzwork.co.uk/tweetfleet-slack-invites/):
@blitzmann
* [Gitter chat](https://gitter.im/pyfa-org/Pyfa): @ blitzmann
* Email: sable.blitzmann@gmail.com
## CCP Copyright Notice
EVE Online, the EVE logo, EVE and all associated logos and designs are the intel
lectual property of CCP hf. All artwork, screenshots, characters, vehicles, stor
ylines, world facts or other recognizable features of the intellectual property
relating to these trademarks are likewise the intellectual property of CCP hf. E
VE Online and the EVE logo are the registered trademarks of CCP hf. All rights a
re reserved worldwide. All other trademarks are the property of their respective
owners. CCP hf. has granted permission to pyfa to use EVE Online and all associ
ated logos and designs for promotional and information purposes on its website b
ut does not endorse, and is not in any way affiliated with, pyfa. CCP is in no w
ay responsible for the content on or functioning of this program, nor can it be
liable for any damage arising from the use of this program.