{"id":16927812,"url":"https://github.com/cantino/huginn_xero_agent","last_synced_at":"2025-04-11T17:43:19.286Z","repository":{"id":56876943,"uuid":"103690949","full_name":"cantino/huginn_xero_agent","owner":"cantino","description":"Huginn Agent for Xero invoice creation","archived":false,"fork":false,"pushed_at":"2017-09-16T01:06:57.000Z","size":9,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-04T21:12:31.695Z","etag":null,"topics":["hackathon"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cantino.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-15T18:51:52.000Z","updated_at":"2020-07-18T17:40:02.000Z","dependencies_parsed_at":"2022-08-20T23:10:35.824Z","dependency_job_id":null,"html_url":"https://github.com/cantino/huginn_xero_agent","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cantino%2Fhuginn_xero_agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cantino%2Fhuginn_xero_agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cantino%2Fhuginn_xero_agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cantino%2Fhuginn_xero_agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cantino","download_url":"https://codeload.github.com/cantino/huginn_xero_agent/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248451796,"owners_count":21105941,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hackathon"],"created_at":"2024-10-13T20:35:11.005Z","updated_at":"2025-04-11T17:43:19.249Z","avatar_url":"https://github.com/cantino.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Huginn Xero Agent\n\n\u003cimg src=\"https://www.xero.com/content/dam/xero/images/opengraph/opengraph-xero.png\" height=150px\u003e\n\n## Installation\n\nAdd this string to your Huginn's .env `ADDITIONAL_GEMS` configuration:\n\n```ruby\nADDITIONAL_GEMS=huginn_xero_agent\n```\n\nAnd then execute:\n\n    $ bundle\n\n## Adding to your Huginn instance\n\n\u003cimg src=\"https://raw.github.com/huginn/huginn/master/media/huginn-logo.png?s=100\" height=100px\u003e\n\nSince you'll need a personal Xero application to authorize API access, visit https://app.xero.com and register a new private application. You'll need a X509 Public Key Certificate, which you can generate like this:\n\n```shell\nopenssl genrsa -out privatekey.pem 1024\nopenssl req -new -x509 -key privatekey.pem -out publickey.cer -days 1825\n```\n\nNow copy publickey.cer and paste it in to the web UI.\n\nYou'll be given consumer key and secret, which you should put into the .env file of your Huginn instance along with the path to your private key:\n\n```\nADDITIONAL_GEMS=huginn_xero_agent\nXERO_CONSUMER_KEY=HCJI7Q...\nXERO_CONSUMER_SECRET=PHOD...\nXERO_PRIVATE_KEY_PATH=/path/to/your/privatekey.pem\n```\n\n## Development\n\nRunning `rake` will clone and set up Huginn in `spec/huginn` to run the specs of the Gem in Huginn as if they would be build-in Agents. The desired Huginn repository and branch can be modified in the `Rakefile`:\n\n```ruby\nHuginnAgent.load_tasks(branch: '\u003cyour branch\u003e', remote: 'https://github.com/\u003cgithub user\u003e/huginn.git')\n```\n\nMake sure to delete the `spec/huginn` directory and re-run `rake` after changing the `remote` to update the Huginn source code.\n\nAfter the setup is done `rake spec` will only run the tests, without cloning the Huginn source again.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\n1. Fork it ( https://github.com/cantino/huginn_xero_agent/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcantino%2Fhuginn_xero_agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcantino%2Fhuginn_xero_agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcantino%2Fhuginn_xero_agent/lists"}