Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/somaticio/tensorflow.rb
tensorflow for ruby
https://github.com/somaticio/tensorflow.rb
Last synced: 11 days ago
JSON representation
tensorflow for ruby
- Host: GitHub
- URL: https://github.com/somaticio/tensorflow.rb
- Owner: somaticio
- License: bsd-3-clause
- Created: 2016-06-16T14:59:51.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-01-10T15:41:18.000Z (almost 3 years ago)
- Last Synced: 2024-04-13T14:20:32.192Z (7 months ago)
- Language: Ruby
- Homepage:
- Size: 2.63 MB
- Stars: 826
- Watchers: 49
- Forks: 66
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tensorflow - tensorflow.rb - TensorFlow native interface for ruby using SWIG (Libraries)
- Awesome-TensorFlow-Chinese - tensorflow.rb - TensorFlow native interface for ruby using SWIG (库 / 微信群)
- awesome-tensorflow - tensorflow.rb - TensorFlow native interface for ruby using SWIG (Libraries)
- fucking-awesome-tensorflow - tensorflow.rb - TensorFlow native interface for ruby using SWIG (Libraries)
README
# tensorflow.rb
(NOTE: this doesn't work anymore)
## Description
This repository contains a Ruby API for utilizing [TensorFlow](https://github.com/tensorflow/tensorflow).
| **`Linux CPU`** | **`Linux GPU PIP`** | **`Mac OS CPU`** |
|--------------------|----------------------|------------------|
| [](https://circleci.com/gh/somaticio/tensorflow.rb) | _Not Configured_ | _Not Configured_ |
[](https://codeclimate.com/github/somaticio/tensorflow.rb)
[](https://gitter.im/tensorflowrb/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://inch-ci.org/github/somaticio/tensorflow.rb)
## Documentation
Everything is at [RubyDoc](http://www.rubydoc.info/github/somaticio/tensorflow.rb).
You can also generate docs by
```bundle exec rake doc```.
## Blog Posts
1. [Introductory blog post](https://medium.com/@Arafat./introducing-tensorflow-ruby-api-e77a477ff16e#.mhvj9ojlj)
2. [Developers blog post](https://medium.com/@Arafat./ruby-tensorflow-for-developers-2ec56b8668c5#.97tng1qqi)
3. [Image Recognition Tutorial](https://medium.com/@Arafat./image-recognition-in-ruby-tensorflow-df5d5c05389b#.ty1vygtrg)
## Installation
### Install Script
I have made a make shift install script in tools directory. You are free to use it, but it still needs some work and there is a chance that you might face some issues with it and if you do face some issues, you can use the instructions below. You are welcome to make improvements to the script.
### Docker
It's easiest to get started using the prebuilt Docker container.
Launch:
```
docker run --rm -it nethsix/ruby-tensorflow-ubuntu:0.0.1 /bin/bash
```
Test:
```
cd /repos/tensorflow.rb/
bundle exec rspec
```
Image Classification Tutorial:
```
cd /repos/tensorflow.rb/image/
cat README
```
For more details about all the fun machine-learning stuff already pre-installed, see: https://hub.docker.com/r/nethsix/ruby-tensorflow-ubuntu/
### Outside of Docker
Alternatively, you can install outside of a Docker container by following
the following steps.
#### Explicit dependencies
- Ruby >= 2.2.0
- [Bazel](http://www.bazel.io/docs/install.html)
- [TensorFlow](https://www.tensorflow.org/install/)
- [Swig](http://www.swig.org/download.html)
#### Implicit dependencies (No Action Required)
- [Google-Protoc gem](https://github.com/google/protobuf/tree/master/ruby) ( for installation do ```gem install google-protoc --pre ```)
- [Protobuf](https://github.com/google/protobuf)
#### Installation
All the dependencies mentioned above must be installed in your system before you proceed further.
#### Clone and Install TensorFlow
This package depends on the TensorFlow shared libraries, in order to compile
these libraries do the following:
```
git clone --recurse-submodules https://github.com/tensorflow/tensorflow
cd tensorflow
./configure
```
This command clones the repository and a few sub modules. After this you should do:
```
bazel build -c opt //tensorflow:libtensorflow.so
```
This command takes in the order of 10-15 minutes to run and creates a shared library. When finished, copy the newly generated libtensorflow.so shared library:
```
# Linux
sudo cp bazel-bin/tensorflow/libtensorflow.so /usr/lib/
sudo cp bazel-bin/tensorflow/libtensorflow_framework.so /usr/lib
# OSX
sudo cp bazel-bin/tensorflow/libtensorflow.so /usr/local/lib
sudo cp bazel-bin/tensorflow/libtensorflow_framework.so /usr/lib
export LIBRARY_PATH=$PATH:/usr/local/lib (may be required)
```
#### Install `tensorflow.rb`
Clone and install this Ruby API:
```
git clone https://github.com/somaticio/tensorflow.rb.git
cd tensorflow.rb/ext/sciruby/tensorflow_c
ruby extconf.rb
make
make install # Creates ../lib/ruby/site_ruby/X.X.X//sciruby/Tensorflow.{bundle, so}
cd ./../../..
bundle install
bundle exec rake install
```
The last command is for installing the gem.
#### Run tests and verify install
```
bundle exec rake spec
```
This command is to run the tests.
## Tensorboard
You can run tensorboard on tensorflow.rb too. Just take a look at tensorboard.md file.
## License
Copyright (c) 2016, Arafat Dad Khan.
[somatic](http://somatic.io)
All rights reserved.
## Acknowledgements
* The [Ruby Science Foundation](http://sciruby.com/) and [somatic](http://somatic.io) for mentoring and sponsoring the project