Laravel-Centric Documentation for Neuron

[markcofano]

I would like to express my appreciation for this project. It's giving me hope that my company's 15 year investment in a custom PHP platform has not hit a dead end.

At the same, time, I would like to ask that Neuron does not presume that everyone here understands, uses, or even endorses Laravel. We have spent countless hours to build a solution that does not depend on Laravel (or very much of anything else) other than Javascript and our own internal "meta-language"

Our applications are highly secure and performant. We are 100% non-dependent on the course changes of Laravel, and we suffer none of the dependencies of shared codebases such as Bootstrap, et al.

Yes, Laravel is used by 60% of PHP developers. But is not used by the other 40%. That's a lot of potential Neuron users. And since our company is in the 40%, I am speaking out.

When the only version of documentation that comes from Neuron presupposes that we use Laravel, it is very frustrating. I must look at code that cannot work as offered. I actually considered installing Laravel the other day for the sole purpose of having an easier way to understand how Neuron works. Twilio does the same thing. It is maddening. Why can't we have equivalent documenation that we can copy / paste and run with only PHP and Neuron?

So please, take the time to have documentation and example code for Neuron that has NO dependencies on anything other than the latest supported versions of PHP. Thank you for considering my suggestion.

[ilvalerione]

Neuron has zero dependency from Laravel and any other framework. It's just a PHP package. What part of the documentation are you referring to?

[markcofano]

I am not saying Neuron is dependent on Laravel. I am saying that Neuron documentation examples

https://www.youtube.com/watch?v=ymSUOIxjoeM

Presuppose we can just fire up Laravel and enter the sample code as you do on screen.

[markcofano]

And as a follow up comment, while it is awesome to have "conceptual code examples" it would also be very helpful to go deeper with a specific and "hello world" example for things like AI access to Database, and RAG.

Since Neuron is expert in Neuron, we find the code examples to have too much abstraction.

For example, please provide the shortest amount of PHP code and support files for a RAG test.

-- instantiates a Neuron Agent with RAG
-- provide a few RAG files (text / image) etc.
-- demonstrate in the sample code where to put these files for ingestion
-- provide one or two prompt examples and a specific LLM provider
-- show how the prompt changes before and after RAG

The examples can be very terse and short. But adapting "working" code to make it work better (breaking it and finding out why) is infinitely easier than taking abstract code and fiddling with it to make it work. I hope this is helpful.

[ilvalerione]

Thank you for sharing your concerns. I'll take them in consideration for future code examples!

[markcofano]

For us and our clients, RAG is the Killer app. We need to implement it without delay. I believe that many concrete examples in this area in particular, will speed Neuron adoption. Thank you.